Documentation Index
Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
Use this file to discover all available pages before exploring further.
The Yativo Fiat API enables you to send and receive money globally, manage virtual accounts, perform currency exchange, and verify customer identities. All endpoints return JSON responses.
Base URLs
| Environment | Base URL |
|---|
| Production | https://api.yativo.com/api/v1 |
| Sandbox | https://smtp.yativo.com/api/v1 |
Authentication
All API requests require a Bearer token obtained from the authentication endpoint. Tokens expire after 600 seconds (10 minutes).
Authorization: Bearer YOUR_ACCESS_TOKEN
Idempotency
All POST, PUT, and PATCH requests require an Idempotency-Key header. This ensures that duplicate requests (e.g. due to network retries) are not processed twice.
Idempotency-Key: your-unique-key-here
payout-{customer_id}-{timestamp}). Keys are scoped to your account.
Rate limits
Requests are rate-limited per API key. If you exceed the limit, you will receive a 429 Too Many Requests response. Implement exponential backoff when retrying after rate limit errors.
All successful responses follow this structure:
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": { ... }
}
Error codes
| Status Code | Meaning |
|---|
200 | OK — Request succeeded |
201 | Created — Resource created successfully |
400 | Bad Request — Invalid request parameters |
401 | Unauthorized — Missing or invalid token |
404 | Not Found — Resource does not exist |
422 | Unprocessable Entity — Validation failed |
429 | Too Many Requests — Rate limit exceeded |
500 | Internal Server Error — Something went wrong on our end |
{
"status": "error",
"status_code": 422,
"message": "Validation failed",
"errors": {
"customer_email": ["The customer email field is required."]
}
}
| Platform | Base URL |
|---|
| KYC API | https://kyc.yativo.com |
| Individual KYC | https://kyc.yativo.com/individual/{customer_id} |
| Business KYB | https://kyc.yativo.com/business/{customer_id} |
