Skip to main content
Every API request to Busha returns a unique request identifier in the response headers. Use request IDs to track specific API calls and expedite issue resolution when contacting Busha support.

​
What is a Request ID?

A request ID is a unique identifier assigned to every API request. It helps both you and Busha support team pinpoint specific API calls for debugging and troubleshooting. Format: req_ followed by an alphanumeric string Example: req_JfPBXEC5rLHc Validity: Request IDs are available for 21 days after the request is made.

​
How to Find the Request ID

The request ID is returned in the response headers of every API call under the X-Request-Id header.

​
Example Request

curl -X GET https://api.sandbox.busha.so/v1/balances \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -i
The -i flag includes response headers in the output.

​
Example Response Headers

HTTP/1.1 200 OK
Date: Wed, 18 Feb 2026 13:29:10 GMT
Content-Type: application/json
X-Request-Id: req_JfPBXEC5rLHc
The request ID is: req_JfPBXEC5rLHc

​
Viewing Request IDs in Code

const axios = require('axios');

try {
  const response = await axios.get(
    'https://api.sandbox.busha.so/v1/balances',
    {
      headers: { 'Authorization': 'Bearer YOUR_SECRET_KEY' }
    }
  );
  
  // Get request ID from response headers
  const requestId = response.headers['x-request-id'];
  console.log('Request ID:', requestId);
  
} catch (error) {
  // Also available in error responses
  const requestId = error.response?.headers['x-request-id'];
  console.error('Error Request ID:', requestId);
}

import requests

response = requests.get(
    'https://api.sandbox.busha.so/v1/balances',
    headers={'Authorization': 'Bearer YOUR_SECRET_KEY'}
)

# Get request ID from response headers
request_id = response.headers.get('X-Request-Id')
print(f'Request ID: {request_id}')

# Also available in error responses
try:
    response = requests.post(...)
except requests.exceptions.RequestException as e:
    request_id = e.response.headers.get('X-Request-Id')
    print(f'Error Request ID: {request_id}')

<?php
$ch = curl_init('https://api.sandbox.busha.so/v1/balances');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_SECRET_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true);

$response = curl_exec($ch);
$header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$headers = substr($response, 0, $header_size);

// Extract request ID from headers
preg_match('/X-Request-Id: (.+)/', $headers, $matches);
$requestId = trim($matches[1]);

echo "Request ID: " . $requestId;
curl_close($ch);
?>

​
When to Use Request IDs

​
Reporting API Errors

When contacting Busha support about API issues, always include the request ID. This helps our team quickly locate the specific request in our logs. Example support message:
“I’m getting a 500 error when creating a quote. Request ID: req_JfPBXEC5rLHc”

​
Debugging Failed Requests

If an API call fails or returns unexpected results, save the request ID along with your error logs for easier debugging. 
// Log request ID with errors
catch (error) {
  const requestId = error.response?.headers['x-request-id'];
  logger.error({
    message: 'Quote creation failed',
    requestId: requestId,
    error: error.message
  });
}

​
Tracking Specific Operations

For critical operations, store the request ID alongside the resource ID (e.g., transfer ID, quote ID) for complete audit trails. 
const quoteResponse = await createQuote(params);
const requestId = quoteResponse.headers['x-request-id'];

// Store both IDs
await database.save({
  quoteId: quoteResponse.data.id,      // QUO_abc123
  requestId: requestId,                 // req_xyz789
  timestamp: new Date()
});
21-Day Retention: Request IDs are only available for 21 days. Don’t rely on them for long-term auditing.