GEgetmaintainx
Categories

List categories

Changed on

Endpoint used to list category resources

get/categories

Request

  • Base URL
    https://api.getmaintainx.com/v1
  • Auth
    HTTP bearer

Query parameters

cursorstring

Last pagination reference

limitinteger

max number of Categories returned

Headers

x-organization-idinteger

Required if using a multi organizations token

Response

Successfully fetched Categories list

nextCursorstring nullable required

The cursor to retrieve the next page of Categories.

nextPageUrlstring nullable required

Path with query parameters that can be used to retrieve the next page of Categories.

Example response

{
  "categories": [
    {
      "id": 963,
      "label": "Safety",
      "description": "Used for everything related to Safety"
    }
  ]
}

Changes

  • 64746cdb0db4Revision changes
    • info

      the response property became required for the status

    • info

      the response property became required for the status

  • 222e6fad7c1fRevision changes
    • info

      added the new optional header request parameter x-organization-id

    • info

      added the optional property // to the response with the status