API errors
API errors
Every Partners API error is an RFC 9457 problem document whose type field links to one of these pages. Each page explains what the error means and how to handle it.
400Bad requestThe request was malformed or a parameter had an invalid value. The detail field says which one.400Validation failedOne or more fields in the request failed validation. The errors array lists each field and what is wrong with it.401UnauthorizedThe request carried no usable credentials: the bearer token is missing, invalid or expired, or the client credentials were rejected.403ForbiddenThe credentials are valid but this operation is not allowed for your account. The detail field says why.404Not foundThe resource in the request URL does not exist.409ConflictThe request is valid but conflicts with the current state of the resource. The detail field says which conflict you hit.422Unprocessable entityThe request is well formed and valid, but the operation it asks for cannot be carried out. The detail field explains why.422Idempotency key reusedThis X-Idempotency-Key was already used with a different request body within the last 48 hours.423LockedA request with the same X-Idempotency-Key is still being processed. Wait briefly, then retry with the same key.429Rate limit exceededYou have sent too many requests in the current window. Wait for the time in Retry-After, then try again.500Internal server errorSomething failed on Firsty's side. The request may or may not have taken effect, so verify state before re-attempting.503Service unavailableThe resource is temporarily unable to handle the request. Wait a moment, then retry.