HTTP status codes

Figure Markets APIs use standard HTTP status codes. The following are the ones you will commonly see and how we use them:

Code	Meaning	How we use it
400	Bad Request	Validation error: missing or invalid parameters, malformed body, or request that fails business rules. Check the response body for details (e.g. field-level errors).
401	Unauthorized	Authentication failed or token missing/expired. For bearer-token APIs: obtain a new token and retry.
403	Forbidden	Authenticated but not allowed to perform this action (e.g. wrong credentials for this API, insufficient permissions, or resource not accessible to this account).
429	Too Many Requests	Rate limit exceeded. Implement backoff (e.g. exponential) and retry after the indicated period or header (e.g. Retry-After).
5xx	Server Error	Server or gateway error. Retry with backoff; if persistent, contact apisupport@figuremarkets.com.

For the exact error response shape (e.g. JSON body with code, message, or details), see the OpenAPI spec for the API you are calling. Success responses use 2xx (typically 200 OK or 201 Created).