Get account request status

GET

/order/v1/banking/accounts/requests/{accountRequestId}

• Production
• Sandbox

Retrieve the onboarding status of a banking account creation request, including the documents currently attached to it.

Authorizations

• Bearer

Parameters

Path Parameters

accountRequestId

required

string format: uuid

Identifier of the account creation request

Responses

200

The resource was returned successfully

object

accountRequestId

required

Identifier of the account creation request.

string

Example

d3f46d1e-3f35-4cf9-9bcb-15c0b7c8f84a

status

required

Current status of the account creation request.

string

Allowed values: PENDING APPROVED REPROVED CONFIRMED PENDING_DOCUMENTS

Example

PENDING

holderType

Holder type of the request. Determines which onboarding document types this request accepts and which of them are mandatory.

string

Allowed values: INDIVIDUAL ORGANIZATION

Example

INDIVIDUAL

step

Current onboarding step of the account creation request.

string

Allowed values: PENDING_ANALYSE PENDING_PIX_KEY PENDING_FEE PENDING_CONFIRMATION COMPLETED

Example

PENDING_ANALYSE

accountId

Identifier of the account created from this request (present after approval).

string format: uuid

Example

30825afc-4fe3-409d-b1e9-b6c1914c11dd

reprovedReason

Reproval reason (present only when status is REPROVED or PENDING_DOCUMENTS).

string

Allowed values: MISSING_DATA INVALID_DOCUMENT RISK OTHER

Example

MISSING_DATA

reprovedDescription

Free-text detail of the reproval (present only when status is REPROVED or PENDING_DOCUMENTS).

string

Example

Proof of address is older than 90 days.

reprovedFields

Onboarding document fields that must be resent (present only when status is REPROVED or PENDING_DOCUMENTS).

Array<string>

Allowed values: socialContract cnpjCard balanceSheet partnerProofAddress documentRepresentative selfieRepresentative documentHolder selfieHolder accountTerms proofAddress proofBankAddress ir kyc pepDeclaration incomeStatement

Example

[
  "proofAddress"
]

documents

required

Files currently attached to the request, one entry per file, grouped by documentType in the order the types are declared. A documentType appears more than once when several files were appended to it (one identity document, selfie or proof of address per partner or legal representative). Files that were replaced are not listed.

Array<object>

object

documentType

required

Onboarding document type this file was uploaded as.

string

Allowed values: socialContract cnpjCard balanceSheet partnerProofAddress documentRepresentative selfieRepresentative documentHolder selfieHolder accountTerms proofAddress proofBankAddress ir kyc pepDeclaration incomeStatement

Example

documentRepresentative

documentId

required

Identifier returned as documentId by the upload onboarding document endpoint. Requests created with document URLs in the payload return that URL here instead.

string

Example

d3f46d1e-3f35-4cf9-9bcb-15c0b7c8f84a

uploadedAt

When the file was attached. Present for files appended alongside the first one of the same documentType.

string format: date-time

Example

2026-08-31T10:15:00.000Z

missingRequiredDocuments

required

Mandatory onboarding document types for this holderType that are still missing from the request. Empty when nothing is pending, and always empty when holderType is unknown.

Array<string>

Allowed values: socialContract cnpjCard balanceSheet partnerProofAddress documentRepresentative selfieRepresentative documentHolder selfieHolder accountTerms proofAddress proofBankAddress ir kyc pepDeclaration incomeStatement

Example

[
  "selfieHolder",
  "pepDeclaration"
]

400

object

error

string

Example

INVALID_REQUEST

message

string

details

Array<object>

object

field

string

issue

string

description

string

Example

[
  {
    "field": "field_name",
    "issue": "INVALID",
    "description": "Field is invalid"
  }
]

401

Unauthorized Request

object

error

string

Example

UNAUTHORIZED

message

string

Example

Unauthorized Request

details

Array<object>

object

field

string

issue

string

description

string

Example

[]

403

object

error

string

Example

FORBIDDEN_ERROR

message

string

details

Array<object>

object

field

string

issue

string

description

string

Example

[]

404

Resource not found

object

error

string

Example

NOT_FOUND

message

string

Example

Resource not found

details

Array<object>

object

field

string

issue

string

description

string

Example

[]

500

object

error

string

Example

INTERNAL_ERROR

message

string

details

Array<object>

object

field

string

issue

string

description

string

Example

[]