Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Reference for the Mippo LaaS REST API covering base URLs, versioning, rate limits, request signing, and the shared error response format.
| Environment | Base URL |
|---|---|
| Production | https://api.mippo.io |
| Sandbox | https://sandbox-api.mippo.io |
/v1/laas/. Partner management endpoints are under /laas/partner/.
| Scope | Limit |
|---|---|
| Per API key | 100 requests / minute |
| KYC submissions | 20 / minute per key |
| Transaction initiations | 50 / minute per key |
429 Too Many Requests with a Retry-After header.
{
"success": false,
"error": {
"code": "SCREAMING_SNAKE_CASE",
"message": "Human-readable description.",
"details": {}
}
}
| Code | HTTP | Meaning |
|---|---|---|
INVALID_API_KEY | 401 | Key missing, malformed, or revoked |
PARTNER_SUSPENDED | 403 | Partner account has been suspended |
KYC_REJECTED | 422 | Client failed compliance screening |
KYC_TOKEN_EXPIRED | 422 | KYC token is older than 24h |
INVALID_WALLET_ADDRESS | 422 | Wallet address failed checksum validation |
TRANSACTION_NOT_FOUND | 404 | Transaction ID does not exist |
MFA_INVALID_CODE | 422 | TOTP code is wrong or expired |
RATE_LIMIT_EXCEEDED | 429 | Too many requests |
INTERNAL_ERROR | 500 | Mippo-side error — contact support |
POST endpoints, send an Idempotency-Key header (any unique string, e.g. a UUID) to safely retry on network failures. Duplicate requests with the same key return the cached response.
curl -X POST https://api.mippo.io/v1/laas/transactions/initiate \
-H "X-Mippo-API-Key: sk_live_..." \
-H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
-H "Content-Type: application/json" \
-d '{ ... }'