> ## Documentation Index
> Fetch the complete documentation index at: https://docs.light.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# List reimbursement categories

> Returns a paginated list of the company's reimbursement categories. Every expense line needs one: the category decides the GL account and tax code its reimbursement books to.



## OpenAPI

````yaml /openapi-public.json get /v1/reimbursement-categories
openapi: 3.0.1
info:
  title: Light API
  version: 1.0.0
servers: []
security:
  - apiKeyAuth: []
  - bearerAuth: []
paths:
  /v1/reimbursement-categories:
    get:
      tags:
        - v1 - Reimbursement categories
      summary: List reimbursement categories
      description: >-
        Returns a paginated list of the company's reimbursement categories.
        Every expense line needs one: the category decides the GL account and
        tax code its reimbursement books to.
      operationId: listReimbursementCategories
      parameters:
        - name: entityIds
          in: query
          description: Restrict to categories available for these company entities
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
              format: uuid
        - name: sort
          in: query
          schema:
            type: string
            description: >-
              Sort string in the format `field:direction`. To provide multiple
              sort fields, separate them with commas.


              Available directions: `asc`, `desc`. 


              Available fields: `createdAt`, `label`.
            example: amount:desc,createdAt:asc
        - name: filter
          in: query
          schema:
            type: string
            description: >-
              Filter string in the format `field:operator:value`. To provide
              multiple filters, separate them with commas.


              Available operators: `eq`, `ne`, `in`, `not_in`, `gt`, `gte`,
              `lt`, `lte`.
               - For `in` and `not_in` operators, provide multiple values separated by the pipe character (`|`). 

              Available fields: `label`, `status`, `id`, `createdAt`.
            example: state:in:IN_DRAFT|SCHEDULED|PAID,amount:gte:500,vendorId:ne:null
        - name: searchTerm
          in: query
          description: Matches against the category label
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of items to return. Default is 50, maximum is 200.
          schema:
            maximum: 200
            type: integer
            format: int32
        - name: offset
          in: query
          description: >-
            Number of items to skip before starting to collect the result set.
            Deprecated, use 'cursor' instead.
          deprecated: true
          schema:
            type: integer
            format: int64
        - name: cursor
          in: query
          description: >-
            The cursor position to start returning results from.

            To opt-in into cursor-based pagination, provide `0` for the initial
            request.

            For subsequent requests, use `nextCursor` and `prevCursor` from the
            previous response to navigate.

            Cursor values are opaque and should not be constructed manually.
          schema:
            type: string
      responses:
        default:
          description: default response
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: >-
                  #/components/schemas/ExternalPaginatedResponseV1ModelExternalReimbursementCategoryV1Model
components:
  schemas:
    ExternalPaginatedResponseV1ModelExternalReimbursementCategoryV1Model:
      type: object
      properties:
        records:
          type: array
          description: List of records for the current page
          items:
            $ref: '#/components/schemas/ExternalReimbursementCategoryV1Model'
        hasMore:
          type: boolean
          description: Boolean flag indicating if there are more records available
        total:
          type: integer
          description: >-
            Total number of records (only for offset pagination). This field is
            not guaranteed to be returned and only available for offset
            pagination, please do not rely on it and migrate to cursor
            pagination.
          format: int64
          nullable: true
          deprecated: true
        nextCursor:
          type: string
          description: Cursor for fetching the next page (only for cursor pagination)
          nullable: true
        prevCursor:
          type: string
          description: Cursor for fetching the previous page (only for cursor pagination)
          nullable: true
    ExternalReimbursementCategoryV1Model:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the reimbursement category
          format: uuid
        companyId:
          type: string
          description: ID of the company
          format: uuid
        companyEntityIds:
          uniqueItems: true
          type: array
          description: Company entities this category is available for
          items:
            type: string
            description: Company entities this category is available for
            format: uuid
        label:
          type: string
          description: Display name of the category
        accountId:
          type: string
          description: GL account a reimbursement line with this category books to
          format: uuid
        taxCodeId:
          type: string
          description: Tax code applied to a reimbursement line with this category
          format: uuid
          nullable: true
        context:
          type: string
          description: Free-text guidance describing when the category applies
          nullable: true
        status:
          type: string
          description: >-
            Status of the reimbursement category


            ⚠️ This enum is not exhaustive; new values may be added in the
            future.
          nullable: false
          deprecated: false
          enum:
            - ACTIVE
        createdAt:
          type: string
          description: Timestamp when the reimbursement category was created
          format: date-time
        updatedAt:
          type: string
          description: Timestamp when the reimbursement category was last updated
          format: date-time
      description: List of records for the current page
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      description: >-
        Basic authentication header of the form **Basic** **<api_key>**, where
        **<api_key>** is your api key.
      name: Authorization
      in: header
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````