Error Handling

Understanding and handling API errors

Error Response Format

{
  "error": "error_code",
  "message": "Human readable message",
  "details": {}
}

HTTP Status Codes

400 · Bad Request

Invalid request parameters

401 · Unauthorized

Invalid or missing API key

404 · Not Found

Resource not found

429 · Too Many Requests

Rate limit exceeded

500 · Internal Server Error

Server error

Example Error Handling

try {
  const response = await fetch('/api/v1/leads');
  
  if (!response.ok) {
    const error = await response.json();
    console.error(error.message);
  }
} catch (error) {
  console.error('Network error:', error);
}