Documentation Index
Fetch the complete documentation index at: https://docs.sertexity.com/llms.txt
Use this file to discover all available pages before exploring further.
Errors
Sertexity uses standard HTTP status codes and returns structured error objects.
Error object
{
"error": {
"code": "VALIDATION_ERROR",
"message": "The 'amount' field must be a positive integer.",
"details": [
{ "field": "amount", "issue": "must_be_positive" }
],
"request_id": "req_7f3a9c12d4e6"
}
}
| Field | Type | Description |
|---|
code | string | Machine-readable error code |
message | string | Human-readable explanation |
details | array | Optional per-field validation breakdown |
request_id | string | Include this in support requests |
HTTP status codes
| Status | Meaning |
|---|
200 OK | Success |
201 Created | Resource created |
204 No Content | Success, no body (e.g. deletion) |
400 Bad Request | Invalid request body or parameters |
401 Unauthorized | Missing or expired token |
403 Forbidden | Authenticated but not permitted |
404 Not Found | Resource does not exist |
409 Conflict | Duplicate resource |
422 Unprocessable Entity | Semantically invalid (e.g. insufficient balance) |
429 Too Many Requests | Rate limit exceeded |
500 Internal Server Error | Unexpected server error |
Error codes
| Code | HTTP | Description |
|---|
VALIDATION_ERROR | 400 | One or more fields failed validation |
INVALID_CREDENTIALS | 401 | Wrong email or password |
TOKEN_EXPIRED | 401 | Access token expired — refresh it |
TOKEN_INVALID | 401 | Malformed or tampered JWT |
FORBIDDEN | 403 | Insufficient permissions |
NOT_FOUND | 404 | Resource not found |
DUPLICATE_EMAIL | 409 | Email already registered |
INSUFFICIENT_BALANCE | 422 | Wallet balance too low |
ASSET_MISMATCH | 422 | Operation asset does not match wallet asset |
RATE_LIMIT_EXCEEDED | 429 | Too many requests |
INTERNAL_ERROR | 500 | Server-side failure |
Retrying
429 — wait the number of seconds in the Retry-After response header.500 — use exponential back-off starting at 1 s, capped at 30 s.- Other
4xx — fix the request before retrying.
