Skip to content

Expense Categories

An Expense Category represents the type of expense that is being reported. Expense categories have no attributes and consist of just their name as a string. They can be changed by Account Administrators.

Operations

Fetching a list of Expense Categories

Request

This endpoint returns structured Expense Category objects. As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array and will be indexed by ID in the expense_categories top-level JSON key. Please see our Response Format section for more information.

Query
matchingstring

By expense category names that match the specified name.

onlystring

Allows you to request one or more resources directly by ID. Multiple IDs can be supplied in a comma separated list, like GET /api/v1/workspaces.json?only=5,6,7.

only_activeboolean

Only include expense categories that have not been deleted (deleted_at is NULL).

Default:true
orderstring

Supply order with the name of a valid sort field for the endpoint and a direction.

Valid values: alphabetical:asc and alphabetical:desc.

Default:"alphabetical:asc"
pageinteger, (int32)
Default:1
per_pageinteger, (int32), <= 200
Default:20
GET
/expense_categories
curl -i -X GET \
  'https://api.mavenlink.com/api/v1/expense_categories?matching=string&only=string&only_active=true&order=alphabetical%3Aasc&page=1&per_page=20'

Responses

A list of Expense Categories have been retrieved.

Bodyapplication/json
countinteger, (int32)
metaobject
resultsArray of objects
expense_categoriesobject
Response
{
  "count": 0,
  "meta": {
    "count": 0,
    "page_count": 0,
    "page_number": 0,
    "page_size": 0
  },
  "results": [
    {
      "key": "string",
      "id": "string"
    }
  ],
  "expense_categories": {
    "property1": {
      "deleted_at": "2019-08-24T14:15:22Z",
      "name": "string"
    },
    "property2": {
      "deleted_at": "2019-08-24T14:15:22Z",
      "name": "string"
    }
  }
}