Proof of Financial Capacity
Submit Proof of Financial Capacity — required to raise a COMPANY subaccount's operating limits and to unlock USD (KYB USD).
Overview
Proof of Financial Capacity demonstrates a COMPANY subaccount's funds or income. Its KYB must be APPROVED first. Approval unlocks USD operations; higher operating limits also require company and UBO Proof of Address.
Submit a bank statement, account balance statement, audited financial statements or an accountant-issued income statement that covers the requested volume.
Use a single-sided PDF dated within the last 3 months. Documents collected during your onboarding may be accepted up to 12 months old.
Flow
- Confirm the
COMPANYsubaccount's KYB isAPPROVED. - Register a
PROOF-OF-FINANCIAL-CAPACITYdocument,PUTthe PDF to the returned URL, and pollGET /api/kyc/document/{documentId}untilready: true. POST /api/kyb/proof-of-financial-capacitywith thedocumentId— Hodle returns anattemptId.- Poll the
attemptIduntilstatus: APPROVED. USD operations unlock on approval; the higher operating limits also require both Proof of Address attempts to beAPPROVED.
Uploading the document
Use the document upload endpoints with documentType: "PROOF-OF-FINANCIAL-CAPACITY".
Register the document — POST /api/kyc/document
curl --request POST \
--url https://api.hodle.com.br/api/kyc/document \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{ "subAccountId": "c852df87-...", "documentType": "PROOF-OF-FINANCIAL-CAPACITY" }'PUT the PDF to the returned uploadUrlFront, then poll readiness (see Uploading documents).
POST /api/kyb/proof-of-financial-capacity
Request
curl --request POST \
--url https://api.hodle.com.br/api/kyb/proof-of-financial-capacity \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"subAccountId": "c852df87-ac61-4259-8242-6451658dfedb",
"uploadedPoFCId": "doc_pofc_9a1..."
}'const res = await fetch(
'https://api.hodle.com.br/api/kyb/proof-of-financial-capacity',
{
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.HODLE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ subAccountId, uploadedPoFCId }),
},
)
const data = await res.json()import os, requests
res = requests.post(
"https://api.hodle.com.br/api/kyb/proof-of-financial-capacity",
headers={
"Authorization": f"Bearer {os.environ['HODLE_API_KEY']}",
"Content-Type": "application/json",
},
json={"subAccountId": sub_account_id, "uploadedPoFCId": uploaded_pofc_id},
)
data = res.json()Parameters
| Field | Type | Required | Description |
|---|---|---|---|
subAccountId | string | Yes | The COMPANY subaccount's id. |
uploadedPoFCId | string | Yes | documentId of the uploaded Proof of Financial Capacity PDF, with ready: true. |
desiredMonthlyLimit | integer | No | Positive monthly ceiling in BRL cents, used when custom limit requests are enabled for your account; otherwise ignored. Defaults to 50000000 (R$ 500,000). Documents submitted while a request is open join that request. |
document | string | No | Optional base64 PDF copy, up to ~10 MB of binary. The uploaded document ID identifies the document reviewed. |
documentMimeType | string | No | MIME type of document, e.g. application/pdf. |
Response
{
"success": true,
"data": {
"attemptId": "pofc_1e6b8f42-9c3d-4a71-b5e8-2f0d6c8a1b34",
"status": "PENDING",
"createdAt": "2026-07-22T22:00:00.000Z"
}
}Save the attemptId and poll for the review outcome.
Errors
| Status | When |
|---|---|
400 | Invalid JSON or parameters, a document type mismatch, or document submission failed. |
401 | Missing or invalid API key. |
404 | Subaccount, document or attempt not found for your platform. |
409 | Limit increases are not configured for your account. Contact support. |
500 | The optional inline document could not be stored. |
{
"success": false,
"error": "Validation failed",
"details": [{ "field": "uploadedPoFCId", "message": "Required" }]
}GET /api/kyb/proof-of-financial-capacity/{attemptId}
Poll the attempt until it resolves.
curl --request GET \
--url https://api.hodle.com.br/api/kyb/proof-of-financial-capacity/pofc_1e6b8f42-9c3d-4a71-b5e8-2f0d6c8a1b34 \
--header "Authorization: Bearer $API_KEY"const res = await fetch(
`https://api.hodle.com.br/api/kyb/proof-of-financial-capacity/${attemptId}`,
{ headers: { Authorization: `Bearer ${process.env.HODLE_API_KEY}` } },
)
const data = await res.json()import os, requests
res = requests.get(
f"https://api.hodle.com.br/api/kyb/proof-of-financial-capacity/{attempt_id}",
headers={"Authorization": f"Bearer {os.environ['HODLE_API_KEY']}"},
)
data = res.json()Response
{
"success": true,
"data": {
"attemptId": "pofc_1e6b8f42-9c3d-4a71-b5e8-2f0d6c8a1b34",
"status": "APPROVED",
"resultMessage": null,
"createdAt": "2026-07-22T22:00:00.000Z",
"updatedAt": "2026-07-22T22:01:43.000Z"
}
}{
"success": true,
"data": {
"attemptId": "pofc_1e6b8f42-9c3d-4a71-b5e8-2f0d6c8a1b34",
"status": "REJECTED",
"resultMessage": "Statement does not cover the declared capacity",
"createdAt": "2026-07-22T22:00:00.000Z",
"updatedAt": "2026-07-22T22:01:43.000Z"
}
}Status values
| Status | Meaning |
|---|---|
PENDING | Under review. Keep polling. |
APPROVED | Final: accepted. USD unlocks; higher limits also require both Proof of Address approvals. |
REJECTED | Final: rejected. Read resultMessage, upload a fresh document and resubmit. |
resultMessage explains a rejection and is otherwise null.
Review timing
Review can take hours. Poll the saved attemptId every few minutes; this attempt has no webhook. Confirm KYB is APPROVED before submitting: documents submitted earlier can be accepted for review and rejected later.