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

  1. Confirm the COMPANY subaccount's KYB is APPROVED.
  2. Register a PROOF-OF-FINANCIAL-CAPACITY document, PUT the PDF to the returned URL, and poll GET /api/kyc/document/{documentId} until ready: true.
  3. POST /api/kyb/proof-of-financial-capacity with the documentId — Hodle returns an attemptId.
  4. Poll the attemptId until status: APPROVED. USD operations unlock on approval; the higher operating limits also require both Proof of Address attempts to be APPROVED.

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

FieldTypeRequiredDescription
subAccountIdstringYesThe COMPANY subaccount's id.
uploadedPoFCIdstringYesdocumentId of the uploaded Proof of Financial Capacity PDF, with ready: true.
desiredMonthlyLimitintegerNoPositive 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.
documentstringNoOptional base64 PDF copy, up to ~10 MB of binary. The uploaded document ID identifies the document reviewed.
documentMimeTypestringNoMIME type of document, e.g. application/pdf.

Response

202 Accepted
{
  "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

StatusWhen
400Invalid JSON or parameters, a document type mismatch, or document submission failed.
401Missing or invalid API key.
404Subaccount, document or attempt not found for your platform.
409Limit increases are not configured for your account. Contact support.
500The optional inline document could not be stored.
400 — validation failed
{
  "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

status: APPROVED
{
  "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"
  }
}
status: REJECTED
{
  "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

StatusMeaning
PENDINGUnder review. Keep polling.
APPROVEDFinal: accepted. USD unlocks; higher limits also require both Proof of Address approvals.
REJECTEDFinal: 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.