Accounts API

Access your chart of accounts.

Scope required: accounts:read

List Accounts


GET /accounts

Returns all accounts in your chart of accounts.

Query Parameters

Parameter	Type	Description
`type`	string	Filter by type: `asset`, `liability`, `equity`, `revenue`, `expense`
`is_active`	boolean	Filter by active status

Example Request


curl -H "Authorization: Bearer rb_live_YOUR_API_KEY" \
  "https://api.rebased.app/api/v1/external/accounts?type=revenue"

Example Response


{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "code": "4000",
      "name": "Sales Revenue",
      "type": "revenue",
      "category": "Operating Revenue",
      "description": "Income from sales",
      "is_active": true,
      "is_system": false,
      "tax_code_id": "660e8400-e29b-41d4-a716-446655440000",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-01T00:00:00Z"
    }
  ],
  "total": 1
}

Get Account


GET /accounts/{id}

Returns a single account by ID.

Path Parameters

Parameter	Type	Description
`id`	string (UUID)	The account ID

Account Object

Field	Type	Description
`id`	string	Unique identifier (UUID)
`code`	string	Account code
`name`	string	Account name
`type`	string	Account type: `asset`, `liability`, `equity`, `revenue`, `expense`
`category`	string	Account category
`description`	string	Account description
`is_active`	boolean	Whether the account is active
`is_system`	boolean	Whether this is a system account
`tax_code_id`	string	Default tax code ID
`created_at`	datetime	When created
`updated_at`	datetime	When last updated

Account Types

Type	Description
`asset`	Things you own (bank accounts, equipment, receivables)
`liability`	Things you owe (loans, payables, tax obligations)
`equity`	Owner’s stake in the business
`revenue`	Income from sales and services
`expense`	Costs of running the business