Retrieve bank accounts

GET

/gp/contracts/:contract_id/banks

GET

/rest/gp/contracts/:contract_id/banks

curl https://api.letsdeel.com/rest/gp/contracts/3x4kkf4/banks \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "id": "c34199c6-5b6f-4e5b-83c9-bb7044f0bfe7",
      "created_at": "2022-05-24T09:38:46.235Z",
      "updated_at": "2022-05-24T09:40:46.235Z",
      "city": "New York",
      "iban": "GB33BUKB20201555555555",
      "email": "user@example.com",
      "phone": "+1234567890",
      "postal": "10001",
      "tax_id": "123-45-6789",
      "bank_code": "BUKB",
      "bank_name": "Barclays Bank",
      "full_name": "John Doe",
      "sort_code": "12345",
      "swift_bic": "BUKBGB22",
      "rib_number": "12345678901",
      "branch_code": "12345",
      "account_type": "checking",
      "country_code": "US",
      "address_line1": "123 Main Street",
      "address_line2": "Apartment 4B",
      "currency_code": "USD",
      "original_name": "Johnathan Doe",
      "account_number": "5555555555",
      "province_state": "NY",
      "bank_branch_name": "Barclays Manhattan Branch",
      "bank_country_code": "GB",
      "ach_routing_number": "021000021",
      "status": "active",
      "funds_distribution": 100
    }
  ]
}

Retrieves the bank accounts configured for a specific contract, including how each account’s share of the salary is split via funds_distribution — use this when a worker has multiple accounts under one contract to see how pay is being distributed across them.

Token scopes: people:read

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

AuthorizationBearer

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

Path parameters

contract_idstringRequired

Unique identifier for a contract.

Response

Successful operation.

datalist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error