Scope: accounting:expenses-accounts.read https://api.alladdin.com/api/v2/expenses-accounts

Returns the list of all expenses accounts in your account.
The response includes both active and archived expenses accounts. Use expenses account IDs when setting defaults on contacts or assigning costs to purchase lines.

Request

import requests

url = "https://api.alladdin.com/api/v2/expenses-accounts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Office Expenses",
      "color": "#FF5733",
      "account_num": 6290001,
      "archived": false,
      "description": "string"
    }
  ]
}

Success responses

200 List of expenses accounts application/json object items[] object[] id string

Unique identifier of the accounting account

name string

Display name of the accounting account

color string

Hex color code used in the UI

account_num integer

Numeric accounting code from the chart of accounts

archived boolean

Whether the account is archived

description string | null

Description of the accounting account

Error responses

401 Invalid or missing API key application/json 403 Insufficient permissions application/json

← PreviousUpdate an expenses account →

Next →Get an expenses account by ID →