List Accounts
Retrieves all accounts associated with the authenticated user.
GET /api/v1/accounts
Response
The response is an array of account objects. The schema below shows field types, rather than a literal JSON response:
[
{
"id": string,
"name": string,
"personal": boolean,
"owner_id": integer,
"created_at": datetime,
"updated_at": datetime,
"account_users": [
{
"id": integer,
"user_id": integer,
"discarded_at": datetime
}
]
}
]
Response Fields
Field | Type | Description |
id | string | Unique identifier returned for the account. It is not required as a path or query parameter for other API requests. |
name | string | Name of the account |
owner_id | integer | User ID of the account owner |
account_users | array | List of users associated with this account |
Account User Response Fields
Field | Type | Description |
id | integer | Unique identifier for the account user |
user_id | integer | Unique identifier for the associated user |
discarded_at | datetime | The date and time that the account user was archived |
Authentication
This endpoint requires user authentication. Include your API token in the request headers.
Example Request
curl -H "Authorization: Bearer YOUR_API_TOKEN" https://app.getdrum.com/api/v1/accounts