Customers

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.

post/customers/{customer_id}/limit-requests

Request

  • Base URL
    https://developers.ozav.io/v2
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Headers

Idempotency-Keystring

Optional idempotency key (16-256 characters of [A-Za-z0-9_-]); same semantics as on money-moving operations.

Request body

monthly_usdstring required

The monthly limit you ask for, in USD, as a decimal string.

per_transaction_usdstring nullable

Optional per-transaction limit, in USD. Cannot exceed monthly_usd.

reasonstring nullable

Why the customer needs more. Short; no personal data.

Example request

{
  "monthly_usd": "50000.00",
  "per_transaction_usd": "10000.00"
}

Response

The limit request was recorded.

idstring required
object'limit_request' required
customer_idstring required
status'awaiting_documents' | 'in_review' | 'approved' | 'declined' | 'canceled' required

awaiting_documents while a proof in documents_due is missing; in_review once everything arrived and OZAV is deciding; approved when the new limit is in force (see approved_limit); declined when OZAV did not raise the limit (no reason is given); canceled when the customer stopped being eligible (rejected, closed or suspended) while the request was open.

reasonstring nullable required
created_atstring date-time required
updated_atstring date-time required
decided_atstring date-time nullable required

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.