account

Read account verification state

Whether this account can use the merchant tools (checkouts and products), and exactly what is missing if it cannot. Send a Bearer JWT or an sk_ API key; NO scope is required. Read-only. Two proofs exist and method says which one applies. A human account proves ownership of a bank account: receive at least requirements.deposit_cents from one CPF/CNPJ and withdraw at least requirements.withdraw_cents back to the SAME document, both inside one window of requirements.max_days_between_legs days, and with the account at least requirements.min_account_age_days old (0 today — no waiting period). The withdrawal is measured in DePix LEAVING the wallet — the amount you enter — not in what lands in the bank, so it is a number you control. An agent account proves a domain instead (POST /api/agents/verify-domain). steps is the checklist in the order it must be done, including converting a little DePix to L-BTC to pay the Liquid network fee — without it a withdrawal cannot be broadcast at all. Render steps as given. Only movements made after this feature went live count — older history never verifies an account by itself. Verification is INDEPENDENT of how much the account may receive: it unlocks tools, never a limit. Poll this while the customer completes the steps, then call POST /api/verification.

get/api/verification

Request

  • Base URL: https://api.depixapp.com
  • URL: https://api.depixapp.com/api/verification
  • Auth: none required

Response

Current verification state.

verifiedboolean required

True when the merchant tools are unlocked on this account.

verified_atstring nullable required

When verification completed (RFC 3339 UTC, "YYYY-MM-DDTHH:MM:SS.sssZ"). Null while unverified.

whatsapp_verified0 | 1 required

1 once the account has verified its WhatsApp number, 0 otherwise (raw SQLite boolean). It gates the first deposit — a human account must clear it in the app before verifying. Always 0 for an agent account, which is exempt (it proves a domain instead).

method'round_trip' | 'domain' required

Which proof applies to this account. round_trip: send money from a CPF/CNPJ to the account and withdraw it back to the SAME document. domain: prove control of a registrable domain by DNS TXT (agent accounts — POST /api/agents/verify-domain).

enabledboolean required

False when automatic verification is switched off platform-wide; contact support instead of retrying.

eligibleboolean required

True when every requirement is satisfied and POST /api/verification would promote the account. A promotion still has to land: a suspended account never verifies.

missingstring[] required

Machine-readable list of what is blocking verification — empty when eligible. Branch on these instead of parsing prose.

unlocksstring[] required

What verification unlocks on this account.

Changes

No recorded changes to this operation across all 1 revision of this API.