List expense categories
Lists the effective hierarchy of expense categories. At least one of employment_id, expense_id, or country_code must be provided.
Authentication
This endpoint accepts any one of the following token types:
- Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
- Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page. See Authorization for customers.
Request
- Base URL: https://gateway.remote.com
- URL: https://gateway.remote.com/v1/expenses/categories
- Auth: HTTP bearer and OAuth 2 (authorization code, authorization URL /auth/oauth2/authorize, token URL /auth/oauth2/token)
Query parameters
The employment ID for which to list categories. Required if neither expense_id nor country_code is provided.
The expense ID for which to list categories (includes the expense's category, even if it is not selectable by default). If provided without employment_id, will use the expense's employment context.
Include un-selectable intermediate categories in the response
Filter categories by country (ISO 3166-1 alpha-3 code, e.g. "GBR"). Only used when neither employment_id nor expense_id is provided.
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 65 revisions of this API.