Expenses
List expense categories for the authenticated employee
Returns the flat list of expense categories applicable to the current employee. Only active categories are returned, filtered by the employee's country / legal-entity visibility rules. Leaf nodes have is_selectable: true; parent nodes are excluded unless include_parents=true.
Scopes
| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage expenses (employment_payments) | View expenses (expense:read) | Manage expenses (expense:write) |
get/v1/employee/expense-categories
Request
- Base URL: https://gateway.remote.com
- URL: https://gateway.remote.com/v1/employee/expense-categories
- Auth: OAuth 2 (client credentials, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/employment.manage, expense:read, expense:write, employment_payments, all:write, all:read)
Query parameters
include_parentsboolean
Include parent (non-selectable) categories in addition to selectable leaves
expense_idstring
Expense ID (slug) whose category should be included in the result, even if it is not selectable by default
Response
Success
Example response
{
"data": [
{
"code": "travel",
"description": "Travel-related expenses",
"instructions": null,
"is_selectable": false,
"parent": null,
"prompt": null,
"scope": "global",
"slug": "travel-abc123",
"status": "active",
"title": "Travel"
},
{
"code": "travel.flights",
"description": "Flight expenses for business travel",
"instructions": "Please include flight confirmation number",
"is_selectable": true,
"parent": {
"code": "travel",
"slug": "travel-abc123",
"title": "Travel"
},
"prompt": "What was the purpose of this flight?",
"scope": "global",
"slug": "travel-flights-abc123",
"status": "active",
"title": "Flights"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.