Check account registration status

Retrieves the registration status of the authenticated Asaas account, broken down into the status of the business data, bank details, documentation and overall approval.

Use this operation to check the account's current status on demand. To track changes in registration status, use the related Webhooks instead of calling this endpoint repeatedly.

Interpreting the statuses

  • commercialInfo: PENDING indicates that the business data has not been fully filled in yet; AWAITING_APPROVAL indicates that it is awaiting manual review.
  • bankAccountInfo: PENDING indicates that the bank details have not been submitted yet.
  • documentation: PENDING indicates that the documentation has not been submitted yet; AWAITING_APPROVAL indicates that the requested documents were submitted, but automatic approval was not completed and the review will continue manually.
  • general: PENDING indicates that the business data or the documentation still has pending items, is under review or was rejected; AWAITING_APPROVAL indicates that the other steps were approved, but overall approval still depends on manual review.
📘

Overall approval

general = APPROVED indicates that the account's overall registration approval has been completed.

For subaccounts subject to annual business data confirmation, this value may remain APPROVED even when the business data has expired, because this pending item is controlled separately.

Related content

Guides

Webhooks

Responses

403

Forbidden. Occurs when the request body is filled, GET method calls must have an empty body.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json