Skip to content

Categories

This group of endpoints allow you to manage expense categories for your business.

Categories classify transactions. System-defined categories (custom: false) can only have their enabled state toggled. Custom categories (custom: true) can have their name updated and can be deleted.

Operations

List categories

Request

Returns a paginated list of expense categories for the given business.

Security
BearerAuth
Path
client_idintegerrequired

The ID of the business.

Example:123
Query
offsetinteger

Offset to retrieve items from.

Default:0
Example:offset=50
limitinteger, <= 500

Number of items per page.

Default:50
Example:limit=50
customboolean

Filter by category type. true returns only custom categories; false returns only system-defined categories. Omit to return all.

GET
/v1/businesses/{client_id}/categories
curl -i -X GET \
  'https://public.letsweel.com/v1/businesses/123/categories?offset=50&limit=50&custom=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
countinteger

Total number of categories.

Example:10
nextstring or null

Pagination cursor for the next page.

Example:"limit=50&offset=50"
previousstring or null

Pagination cursor for the previous page.

Example:null
resultsArray of objects(Category)
Response
{
  "count": 10,
  "next": "limit=50&offset=50",
  "previous": null,
  "results": [
    { … }
  ]
}