Skip to navigation
EndpointsOrganizations

List child organization bank accounts

Beta

List the active bank accounts of one of your child organizations, oldest first, with masked details and the status of each. Use it to show the customer what is on file and whether verification is still pending. Pages are cursor based: pass next_cursor from one response as cursor to get the next page.

Token scopes: organizations:read

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-02-12.

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

child_idstringRequiredformat: "uuid"

Public id of the child organization, as returned in the id field of the create child organization response. It must be a direct child organization of the authenticated organization; any other id answers 403, an unknown id 404.

Headers

X-BetaenumRequiredDefaults to true

Opts in to the beta version of this endpoint. Must be true.

Allowed values:

Query parameters

limitintegerOptional1-100Defaults to 20
Maximum number of bank accounts to return per page.
cursorstringOptionalformat: "^[0-9]+$"<=16 characters

The next_cursor of the previous page. Omit it for the first page.

Response

The active bank accounts of the child organization. An empty list when it has none.
datalist of objects
One page of the active bank accounts of the child organization, oldest first. Removed accounts are not listed.
has_moreboolean
Whether another page follows.
next_cursorstring or null
Value to send as cursor for the next page. Null on the last page.
total_countinteger>=0
Number of active bank accounts of the child organization.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error