Ask for a higher limit for an existing customer
Asks OZAV to raise the limit of an approved customer - most often one approved at the entry limit. A customer that is not approved, or whose account is closed or suspended, answers 409 CUSTOMER_NOT_ELIGIBLE. Send the monthly amount you want (and, optionally, the per-transaction amount and a short reason).
The response lists the proofs of economic capacity that are still missing for that amount in documents_due, each with the doc_type that closes it in POST /customers/{customer_id}/documents. The same items appear in requirements.documents_due of the customer, with purpose: limit_increase, and a requirement.due webhook follows within about 15 minutes. Proofs sent recently and not rejected are not asked again.
The request moves on its own: awaiting_documents while a proof is missing, in_review once everything arrived, and approved (with approved_limit) when OZAV's compliance officer sets the new limit - it can be lower than what you asked. declined carries no reason; canceled means the customer stopped being eligible. Subscribe to limit_request.updated to be told of each change.
One open request per customer: a second one answers 409 LIMIT_REQUEST_ALREADY_OPEN. Do not put personal data in reason.
Request
- Base URLhttps://developers.ozav.io/v2
- Auth
- API key in header X-API-Key
- or HTTP bearer
Headers
Optional idempotency key (16-256 characters of [A-Za-z0-9_-]); same semantics as on money-moving operations.
Request body
Example request
{
"monthly_usd": "50000.00",
"per_transaction_usd": "10000.00"
}Response
The limit request was recorded.
Example response
{
"id": "ozav_lir_01J8Z9K2M3N4P5Q6R7S8T9U0V1",
"customer_id": "ozav_cus_01J8Z9K2M3N4P5Q6R7S8T9U0V1",
"requested": {
"monthly_usd": "50000.00",
"per_transaction_usd": "10000.00"
},
"documents_due": [
{
"key": "bank_statement",
"doc_type": "bank_statement"
}
],
"approved_limit": {
"monthly_usd": "40000.00",
"per_transaction_usd": "10000.00"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.