Error Handling

TalentScreen API uses standard HTTP status codes and returns consistent JSON error objects to help you handle errors gracefully.

Error Response Format

All errors return a JSON object with code, message, and status fields. Additional context may be provided in the details field.

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "status": 400,
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ]
  }
}

HTTP Status Codes

Common Error Codes

Error Handling Example

try {
  const response = await fetch(url, options);
  const data = await response.json();

  if (!response.ok) {
    throw new Error(`${data.error.code}: ${data.error.message}`);
  }

  return data;
} catch (err) {
  logError("module-name", "functionName", "API request failed", { error: err });
  // Handle specific error codes
}