Skip to main content
GET
/
v1
/
accounts
List Accounts
curl --request GET \
  --url https://sandbox.api.rime.finance/v1/accounts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "external_id": "user-12345",
      "type": "individual",
      "country": "Germany",
      "city": "Berlin",
      "line1": "Hauptstraße 123",
      "postal_code": "10115",
      "state": "Berlin",
      "first_name": "Max",
      "last_name": "Mustermann",
      "dob_day": 15,
      "dob_month": 3,
      "dob_year": 1990,
      "place_of_birth": "Munich",
      "tin": "DE123456789",
      "tax_residencies": "DE",
      "created": "2024-01-15T10:30:00Z"
    },
    {
      "id": "456e7890-e89b-12d3-a456-426614174001",
      "external_id": "business-67890",
      "type": "business",
      "country": "Germany",
      "city": "Frankfurt",
      "line1": "Finanzstraße 456",
      "postal_code": "60311",
      "state": "Hessen",
      "business_name": "Tech Solutions GmbH",
      "lei": "529900T8BM49AURSDO55",
      "tax_id": "DE987654321",
      "tax_residencies": "DE",
      "created": "2024-01-15T10:30:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer access token. Provide as a Authorization: Bearer <token> header.

Query Parameters

​
external_id
string | null

Filter for accounts with a specific external ID.

External IDs are identifiers you can attach to an account to help you identify it within your system. This could be a username or user ID from your system, or any other identifier you want to use.

​
account_type
enum<string> | null

Filter between accounts that are either individual or business accounts.

Accounts can either be for a natural person (individual) for a registered business. The type of account has an influence on the parameters required for account creation.

Available options:
individual,
business
​
skip
integer
default:0
Required range: x >= 0
​
limit
integer
default:100
Required range: 1 <= x <= 1000

Response

200 - application/json

List of accounts retrieved successfully

​
data
AccountSchema · object[]
required