Skip to main content

Response Format

All Fincept API endpoints return standardized JSON responses with consistent structure.

Success Response

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    // Endpoint-specific data
  }
}
HTTP Status: 200 OK

Error Response

{
  "success": false,
  "message": "Error summary",
  "detail": "Detailed explanation of what went wrong"
}
HTTP Status: 4xx or 5xx

Common Status Codes

CodeMeaningExample
200SuccessRequest completed
400Bad RequestInvalid parameters
401UnauthorizedMissing/invalid API key
402Payment RequiredInsufficient credits
403ForbiddenTier access required
429Too Many RequestsRate limit exceeded
500Server ErrorInternal error
Learn more →