Error codes
Complete reference of errors that the Colurs API can return.
Authentication errors
| Code | Error | Description |
|---|---|---|
| 400 | Bad Request | Invalid or missing request parameters |
| 401 | Unauthorized | Invalid, expired, or missing token |
| 403 | Forbidden | No permission to execute this operation |
| 404 | Not Found | Resource not found |
| 429 | Too Many Requests | Request rate limit exceeded |
| 500 | Internal Server Error | Internal server error |
Errors by module
Authentication
| Code | Error | Description |
|---|---|---|
| 400 | DataInvalidException | Invalid credentials or unsupported platform |
| 400 | CodeMustBeRequiredException | Code required for PANEL/IOS/ANDROID |
| 400 | CodeExpiredException | Verification code expired |
| 400 | OTPRequiredException | 2FA code is required (user has MFA) |
| 400 | InvalidOTPException | Invalid 2FA code |
Users
| Code | Error | Description |
|---|---|---|
| 400 | InvalidReferrer | Invalid referral code |
| 400 | ProfileAlreadyReferred | Profile already has an assigned referral |
| 404 | ReferalCodeNotExist | Referral code does not exist |
| 400 | TypePersonRequired | Person type is required |
| 400 | InfoBusinessDoesNotExist | Business information does not exist |
| 400 | IntegrationException | Integration error |
Withdrawals
| Code | Error | Description |
|---|---|---|
| 400 | BalanceInsufficient | Insufficient balance for withdrawal |
| 400 | InvalidCurrencyForQuoteWithDraw | Invalid currency for the country |
| 400 | MarketPlaceUserRequired | Active wallet is required |
| 404 | BankAccountNotFound | Bank account not found |
| 422 | UnsupportedBankName | Unsupported bank |
| 422 | UnsupportedDocumentType | Invalid document type |
Payment Links
| Code | Error | Description |
|---|---|---|
| 400 | AmountRequired | Amount is required for general links |
| 400 | AmountMismatch | Amount does not match link amount |
| 400 | InvalidStatus | Link is not in a valid status for payment |
| 404 | NotFound | Payment Link does not exist |
All errors return a JSON body with detail or message
describing the cause of the error.