Docs
Get Accounts
GET /events/{eventId}/accounts
GET
/events/{eventId}/accountsRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Returns all accounts defined on the event, along with their current balance and projected cash flow figures. Accounts are named buckets that organize the event's finances (e.g., "Production Budget", "Catering", "Venue").
Requires EventAccountingAdmin permission on the event.
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| eventId | Guid | Required | The ID of the event. |
Example Response
[
{
"id": "acct-guid-001",
"name": "Production Budget",
"balance": 250000,
"quotedReceivables": 100000,
"quotedPayables": 50000,
"committedReceivables": 75000,
"committedPayables": 25000
},
{
"id": "acct-guid-002",
"name": "Venue",
"balance": -100000,
"quotedReceivables": 0,
"quotedPayables": 100000,
"committedReceivables": 0,
"committedPayables": 0
}
]
Response Fields
| Field | Type | Description |
|---|---|---|
| id | Guid | The account's unique ID. |
| name | string | The account's display name. |
| balance | int | Net balance from all `Paid` transactions (credits minus debits), in cents. |
| quotedReceivables | int | Sum of `quotedAmount` for all `Quoted` credit transactions, in cents. |
| quotedPayables | int | Sum of `quotedAmount` for all `Quoted` debit transactions, in cents. |
| committedReceivables | int | Sum of `invoicedAmount` for all `Committed` credit transactions, in cents. |
| committedPayables | int | Sum of `invoicedAmount` for all `Committed` debit transactions, in cents. |
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token, or caller lacks EventAccountingAdmin. |
NOT_FOUND | 404 | Event not found. |