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

# List reimbursement line items



## OpenAPI

````yaml /spec/openapi.json get /reimbursement_line_items
openapi: 3.0.0
info:
  title: Nmbr API
  description: API to interact with Nmbr Payroll
  version: 1.0.0
servers:
  - url: https://sandbox.nmbr.co/services/payroll
security:
  - CompanyToken: []
tags:
  - name: Accounting Codes
  - name: Accounting Code Rules
  - name: Adjustments
  - name: Allowances
  - name: Allowance Line Items
  - name: Allowance Types
  - name: Async Tasks
  - name: Bank Accounts
  - name: Business Entities
  - name: Business Entity Verifications
  - name: Business Entity ROE Authorizations
  - name: Business Presets
  - name: Calculations
  - name: Companies
  - name: Contractors
  - name: Deductions
  - name: Deduction Line Items
  - name: Deduction Types
  - name: Earnings
  - name: Earning Line Items
  - name: Earning Types
  - name: Effective Tax Properties
  - name: Employees
  - name: Employee Benefits
  - name: Employee Benefit Line Items
  - name: Employee Benefit Types
  - name: Employer Benefits
  - name: Employer Benefit Line Items
  - name: Employer Benefit Types
  - name: Employer Statutory Withholding Line Items
  - name: Employer Statutory Withholding Types
  - name: Forms
  - name: Form Batches
  - name: Form Types
  - name: Holidays
  - name: Integrations
  - name: Journal Entries
  - name: Overtime Rates
  - name: Partners
  - name: Pay Rates
  - name: Pay Schedules
  - name: Pay Splits
  - name: Pay Stubs
  - name: Payments
  - name: Payrolls
  - name: Reimbursements
  - name: Reimbursement Line Items
  - name: Reimbursement Types
  - name: Remittance Accounts
  - name: Remittance Account Enrollments
  - name: Reports
  - name: Statutory Withholding Line Items
  - name: Statutory Withholding Types
  - name: Tags
  - name: Tag Groups
  - name: Tax Properties
  - name: Tax Property Templates
  - name: Tokens
  - name: Usage Records
  - name: Usage Summaries
  - name: Vacation Pay
  - name: Vacation Pay Settings
  - name: Webhooks
  - name: Work Assignments
paths:
  /reimbursement_line_items:
    get:
      tags:
        - Reimbursement Line Items
      summary: List reimbursement line items
      operationId: reimbursement-line-items-index
      parameters:
        - name: pay_stub_id
          in: query
          schema:
            type: string
          required: false
        - name: payroll_id
          in: query
          schema:
            type: string
          required: false
        - name: payroll_status
          in: query
          schema:
            anyOf:
              - type: string
                enum:
                  - approved
                  - draft
                  - failed
                  - paid
                  - partially_paid
                  - processing
              - type: array
                items:
                  type: string
                  enum:
                    - approved
                    - draft
                    - failed
                    - paid
                    - partially_paid
                    - processing
          required: false
        - name: payroll_type
          in: query
          schema:
            anyOf:
              - type: string
                enum:
                  - correction
                  - historical
                  - off_cycle
                  - regular
              - type: array
                items:
                  type: string
                  enum:
                    - correction
                    - historical
                    - off_cycle
                    - regular
          required: false
        - name: payroll_period_start
          in: query
          schema:
            type: object
          required: false
          description: >-
            Date filters support two formats:

            Exact Date Match: Provide a well-formatted date in `YYYY-MM-DD`
            format for an exact match. Example:
            `payroll_period_start=2024-01-01`

            Use an array-like syntax to specify a range with one or more
            comparison operators:

            - `gt` (greater than)

            - `gte` (greater than or equal to)

            - `lte` (less than or equal to)

            - `lt` (less than)

            Example:
            `payroll_period_start[gte]=2024-01-01&payroll_period_start[lt]=2024-12-31`
        - name: payroll_period_end
          in: query
          schema:
            type: object
          required: false
          description: >-
            Date filters support two formats:

            Exact Date Match: Provide a well-formatted date in `YYYY-MM-DD`
            format for an exact match. Example: `payroll_period_end=2024-01-01`

            Use an array-like syntax to specify a range with one or more
            comparison operators:

            - `gt` (greater than)

            - `gte` (greater than or equal to)

            - `lte` (less than or equal to)

            - `lt` (less than)

            Example:
            `payroll_period_end[gte]=2024-01-01&payroll_period_end[lt]=2024-12-31`
        - name: payroll_pay_date
          in: query
          schema:
            type: object
          required: false
          description: >-
            Date filters support two formats:

            Exact Date Match: Provide a well-formatted date in `YYYY-MM-DD`
            format for an exact match. Example: `payroll_pay_date=2024-01-01`

            Use an array-like syntax to specify a range with one or more
            comparison operators:

            - `gt` (greater than)

            - `gte` (greater than or equal to)

            - `lte` (less than or equal to)

            - `lt` (less than)

            Example:
            `payroll_pay_date[gte]=2024-01-01&payroll_pay_date[lt]=2024-12-31`
        - name: pay_schedule_id
          in: query
          schema:
            type: string
          required: false
        - name: work_assignment_id
          in: query
          schema:
            type: string
          required: false
        - name: employee_id
          in: query
          schema:
            type: string
          required: false
        - name: contractor_id
          in: query
          schema:
            type: string
          required: false
        - name: business_entity_id
          in: query
          schema:
            type: string
          required: false
        - name: has_business_preset
          in: query
          schema:
            type: boolean
          required: false
        - name: business_preset_id
          in: query
          schema:
            type: string
          required: false
        - name: include_types
          in: query
          schema:
            anyOf:
              - type: string
                enum:
                  - health_spending_account
                  - non_taxable_reimbursement
                  - professional_membership
                  - taxable_reimbursement
                  - transit_pass
                  - wellness_spending_account
              - type: array
                items:
                  type: string
                  enum:
                    - health_spending_account
                    - non_taxable_reimbursement
                    - professional_membership
                    - taxable_reimbursement
                    - transit_pass
                    - wellness_spending_account
          required: false
        - name: exclude_types
          in: query
          schema:
            anyOf:
              - type: string
                enum:
                  - health_spending_account
                  - non_taxable_reimbursement
                  - professional_membership
                  - taxable_reimbursement
                  - transit_pass
                  - wellness_spending_account
              - type: array
                items:
                  type: string
                  enum:
                    - health_spending_account
                    - non_taxable_reimbursement
                    - professional_membership
                    - taxable_reimbursement
                    - transit_pass
                    - wellness_spending_account
          required: false
        - name: external_ref
          in: query
          schema:
            type: string
          required: false
        - name: earned_on
          in: query
          schema:
            type: object
          required: false
          description: >-
            Only return line items with an `earned_on` date matching the filter.


            Date filters support two formats:

            Exact Date Match: Provide a well-formatted date in `YYYY-MM-DD`
            format for an exact match. Example: `earned_on=2024-01-01`

            Use an array-like syntax to specify a range with one or more
            comparison operators:

            - `gt` (greater than)

            - `gte` (greater than or equal to)

            - `lte` (less than or equal to)

            - `lt` (less than)

            Example: `earned_on[gte]=2024-01-01&earned_on[lt]=2024-12-31`
        - name: expand
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
                - business_preset
                - custom_expense_accounting_code
                - custom_liability_accounting_code
                - custom_tag_assignment
                - expense_accounting_code
                - liability_accounting_code
                - managed_expense_accounting_code
                - managed_liability_accounting_code
                - managed_tag_assignment
                - pay_stub
                - recurrence
                - source_adjustment
                - tag_assignment
                - tag_assignment_amounts
          required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    description: The type of the object in Nmbr (`"list"`).
                    readOnly: true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: The unique identifier of the object in Nmbr.
                          readOnly: true
                        object:
                          type: string
                          description: >-
                            The type of the object in Nmbr
                            (`"reimbursement_line_item"`).
                          readOnly: true
                        data:
                          type: object
                          allOf:
                            - $ref: '#/components/schemas/ReimbursementLineItem'
                          anyOf:
                            - type: object
                              title: Default
                            - type: object
                              title: With pay_stub expanded
                              properties:
                                pay_stub:
                                  type: object
                                  properties:
                                    data:
                                      $ref: '#/components/schemas/PayStub'
                            - type: object
                              title: With recurrence expanded
                              properties:
                                recurrence:
                                  type: object
                                  properties:
                                    data:
                                      $ref: '#/components/schemas/Recurrence'
                            - type: object
                              title: With business_preset expanded
                              properties:
                                business_preset:
                                  type: object
                                  properties:
                                    data:
                                      $ref: '#/components/schemas/BusinessPreset'
                            - type: object
                              title: With source_adjustment expanded
                              properties:
                                source_adjustment:
                                  type: object
                                  properties:
                                    data:
                                      $ref: '#/components/schemas/SourceAdjustment'
                            - type: object
                              title: With expense_accounting_code expanded
                              properties:
                                expense_accounting_code:
                                  type: object
                                  properties:
                                    data:
                                      $ref: >-
                                        #/components/schemas/ExpenseAccountingCode
                            - type: object
                              title: With managed_expense_accounting_code expanded
                              properties:
                                managed_expense_accounting_code:
                                  type: object
                                  properties:
                                    data:
                                      $ref: >-
                                        #/components/schemas/ManagedExpenseAccountingCode
                            - type: object
                              title: With custom_expense_accounting_code expanded
                              properties:
                                custom_expense_accounting_code:
                                  type: object
                                  properties:
                                    data:
                                      $ref: >-
                                        #/components/schemas/CustomExpenseAccountingCode
                            - type: object
                              title: With liability_accounting_code expanded
                              properties:
                                liability_accounting_code:
                                  type: object
                                  properties:
                                    data:
                                      $ref: >-
                                        #/components/schemas/LiabilityAccountingCode
                            - type: object
                              title: With managed_liability_accounting_code expanded
                              properties:
                                managed_liability_accounting_code:
                                  type: object
                                  properties:
                                    data:
                                      $ref: >-
                                        #/components/schemas/ManagedLiabilityAccountingCode
                            - type: object
                              title: With custom_liability_accounting_code expanded
                              properties:
                                custom_liability_accounting_code:
                                  type: object
                                  properties:
                                    data:
                                      $ref: >-
                                        #/components/schemas/CustomLiabilityAccountingCode
                            - type: object
                              title: With tag_assignment expanded
                              properties:
                                tag_assignment:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      description: >-
                                        The unique identifier of the object in
                                        Nmbr.
                                      readOnly: true
                                    object:
                                      type: string
                                      description: The type of the object in Nmbr.
                                      readOnly: true
                                    data:
                                      $ref: '#/components/schemas/TagAssignment'
                            - type: object
                              title: With managed_tag_assignment expanded
                              properties:
                                managed_tag_assignment:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      description: >-
                                        The unique identifier of the object in
                                        Nmbr.
                                      readOnly: true
                                    object:
                                      type: string
                                      description: The type of the object in Nmbr.
                                      readOnly: true
                                    data:
                                      $ref: >-
                                        #/components/schemas/ManagedTagAssignment
                            - type: object
                              title: With custom_tag_assignment expanded
                              properties:
                                custom_tag_assignment:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      description: >-
                                        The unique identifier of the object in
                                        Nmbr.
                                      readOnly: true
                                    object:
                                      type: string
                                      description: The type of the object in Nmbr.
                                      readOnly: true
                                    data:
                                      $ref: '#/components/schemas/CustomTagAssignment'
                            - type: object
                              title: With tag_assignment_amounts expanded
                              properties:
                                tag_assignment_amounts:
                                  type: object
                                  nullable: true
                                  properties:
                                    object:
                                      type: string
                                      description: >-
                                        The type of the object in Nmbr
                                        (`"list"`).
                                      readOnly: true
                                    data:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          id:
                                            type: string
                                            description: >-
                                              The unique identifier of the object in
                                              Nmbr.
                                            readOnly: true
                                          object:
                                            type: string
                                            description: The type of the object in Nmbr.
                                            readOnly: true
                                          data:
                                            $ref: '#/components/schemas/TagAssignmentAmount'
              example:
                object: list
                data:
                  - id: <id>
                    object: reimbursement_line_item
                    data:
                      pay_stub:
                        id: <id>
                        object: pay_stub
                        links:
                          self: /pay_stubs/<id>
                      line_item_type: reimbursement
                      is_managed: false
                      amount: 35
                      custom_amount: null
                      managed_amount: 35
                      accrued_vacation_pay: 0
                      reimbursement_type:
                        id: <id>
                        object: reimbursement_type
                        data:
                          type: non_taxable_reimbursement
                          label: Non-Taxable Reimbursement
                        links:
                          self: /reimbursement_types/non_taxable_reimbursement
                      recurrence: null
                      title: null
                      title_translations: null
                      title_translated: null
                      business_preset: null
                      source_adjustment: null
                      expense_accounting_code: null
                      managed_expense_accounting_code: null
                      custom_expense_accounting_code: null
                      liability_accounting_code: null
                      managed_liability_accounting_code: null
                      custom_liability_accounting_code: null
                      component_settings:
                        attributes_locked: false
                      earned_on: null
                      managed_earned_on: null
                      custom_earned_on: null
                      external_ref: null
                      created_at: '2026-01-01T00:00:00.000000Z'
                      updated_at: '2026-01-01T00:00:00.000000Z'
                    links:
                      self: /reimbursement_line_items/<id>
                links:
                  first: /reimbursement_line_items?pay_stub_id=<id>&page=1
                  last: /reimbursement_line_items?pay_stub_id=<id>&page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  last_page: 1
                  per_page: 15
                  total: 1
                  has_more: false
components:
  schemas:
    ReimbursementLineItem:
      type: object
      title: Reimbursement Line Item
      properties:
        pay_stub:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"pay_stub"`).
              readOnly: true
        line_item_type:
          type: string
          nullable: true
        is_managed:
          type: boolean
          description: >-
            Whether this line item was generated by a Reimbursement recurrence
            and calculated automatically. When `true`, only `custom_amount` can
            be modified and the line item cannot be deleted.
        amount:
          type: number
          description: >-
            The effective amount for this line item. Returns `custom_amount` if
            set, otherwise `managed_amount`. Read-only.
          nullable: true
          format: decimal
        custom_amount:
          type: number
          description: >-
            An override for `managed_amount`. When set, `amount` reflects this
            value instead of `managed_amount`.
          nullable: true
          format: decimal
        managed_amount:
          type: number
          description: >-
            The amount calculated by the system or set by the linked
            Reimbursement recurrence. Read-only; set `custom_amount` to
            override.
          nullable: true
          format: decimal
        accrued_vacation_pay:
          type: number
          description: >-
            The vacation pay accrued on this line item, calculated based on the
            Work Assignment's Vacation Pay Settings.
          nullable: true
          format: decimal
        reimbursement_type:
          type: object
          description: The type of reimbursement for this line item.
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"reimbursement_type"`).
              readOnly: true
            data:
              $ref: '#/components/schemas/ReimbursementType'
        recurrence: {}
        title:
          type: string
          nullable: true
          maxLength: 255
        title_translations:
          type: object
          description: Optional translations for the `title` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        title_translated:
          type: string
          description: >-
            The translation of the `title` property for the request locale.
            Computed using the values in `title` and `title_translations` and
            the value of the request's `Accept-Language` header.
          readOnly: true
        business_preset: {}
        source_adjustment: {}
        expense_accounting_code:
          description: >-
            The effective expense accounting code. Returns the user-set value if
            present, otherwise the system-derived value. Writes to this field
            set the user override.
        managed_expense_accounting_code:
          description: >-
            The expense accounting code derived by the system from accounting
            code rules and presets. Read-only.
        custom_expense_accounting_code:
          description: >-
            User-set expense accounting code that overrides the system-derived
            value.
        liability_accounting_code:
          description: >-
            The effective liability accounting code. Returns the user-set value
            if present, otherwise the system-derived value. Writes to this field
            set the user override.
        managed_liability_accounting_code:
          description: >-
            The liability accounting code derived by the system from accounting
            code rules and presets. Read-only.
        custom_liability_accounting_code:
          description: >-
            User-set liability accounting code that overrides the system-derived
            value.
        component_settings:
          type: object
          description: Settings specific to the Nmbr component.
          nullable: true
          properties:
            attributes_locked:
              type: boolean
              description: >-
                Whether the line item is locked and cannot be edited in the
                component.
        earned_on:
          description: >-
            The effective earned-on date for this line item. Returns
            `custom_earned_on` if set, otherwise `managed_earned_on`. Read-only.
        managed_earned_on:
          type: string
          description: >-
            The earned-on date set by the system. Read-only; set
            `custom_earned_on` to override.
          nullable: true
          format: date
        custom_earned_on:
          type: string
          description: >-
            An override for `managed_earned_on`. When set, `earned_on` reflects
            this value instead of `managed_earned_on`. Must fall within the
            payroll's pay period.
          nullable: true
          format: date
        external_ref:
          type: string
          description: >-
            A reference to the object in an external system, e.g. the primary
            key of the object in your application's database. Nmbr doesn't use,
            validate, parse, or require this value to be unique - it simply
            stores it for your reference.
          nullable: true
          maxLength: 255
        created_at:
          type: string
          description: The date and time the object was created in Nmbr.
          readOnly: true
          format: dateTime
        updated_at:
          type: string
          description: The date and time the object was last updated in Nmbr.
          readOnly: true
          format: dateTime
    PayStub:
      type: object
      title: Pay Stub
      properties:
        payroll:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"payroll"`).
              readOnly: true
        work_assignment:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"work_assignment"`).
              readOnly: true
        payment_method:
          type: string
          description: The payment method for this pay stub.
          enum:
            - direct_deposit
            - manual
            - pad
            - wire
        has_taxes_calculated:
          type: boolean
          description: >-
            Whether tax amounts have been calculated for this pay stub. When
            `false`, amounts in the `employee_summary` and `company_summary` may
            be incomplete.
        is_pending_tax_rates:
          type: boolean
          description: This attribute is deprecated and will be removed.
          deprecated: true
        employee_summary:
          type: object
          description: >-
            A summary of pay for the Employee associated with this pay stub.
            Both `employee_summary` and `contractor_summary` are always present.
            The summary that does not apply is empty rather than omitted, and
            its amounts may be `null` before summaries are calculated. For
            calculated summaries, the side with a non-null `net` is the
            populated summary. `*_ytd` fields contain year-to-date totals
            inclusive of this pay period.
          nullable: true
          properties:
            gross:
              type: number
              description: The sum of all earnings and allowances.
              nullable: true
              format: decimal
            subtractions:
              type: number
              description: The total of all deductions, taxes, and benefit contributions.
              nullable: true
              format: decimal
            reimbursements:
              type: number
              description: The total of non-taxable reimbursements.
              nullable: true
              format: decimal
            net:
              type: number
              description: The Employee net pay; when negative, a warning is included.
              nullable: true
              format: decimal
            gross_ytd:
              type: number
              nullable: true
              format: decimal
            subtractions_ytd:
              type: number
              nullable: true
              format: decimal
            reimbursements_ytd:
              type: number
              nullable: true
              format: decimal
            net_ytd:
              type: number
              nullable: true
              format: decimal
        contractor_summary:
          type: object
          description: >-
            A summary of pay for the Contractor associated with this pay stub.
            Always present. For calculated summaries, a non-null
            `contractor_summary.net` means the contractor summary is populated.
            `*_ytd` fields contain year-to-date totals inclusive of this pay
            period.
          nullable: true
          properties:
            gross:
              description: The sum of all earnings.
            reimbursements:
              description: The total of non-taxable reimbursements.
            net:
              description: The Contractor net pay.
            gross_ytd:
              type: number
              nullable: true
              format: decimal
            reimbursements_ytd:
              type: number
              nullable: true
              format: decimal
            net_ytd:
              type: number
              nullable: true
              format: decimal
        company_summary:
          type: object
          description: >-
            A summary of the company's obligations for this pay stub. `*_ytd`
            fields contain year-to-date totals inclusive of this pay period.
          nullable: true
          properties:
            taxes_and_contributions:
              type: number
              description: The employer share of statutory remittances (CPP and EI).
              nullable: true
              format: decimal
            benefits:
              type: number
              description: The total of employer benefit contributions.
              nullable: true
              format: decimal
            total:
              type: number
              description: The company's total obligations.
              nullable: true
              format: decimal
            taxes_and_contributions_ytd:
              type: number
              nullable: true
              format: decimal
            benefits_ytd:
              type: number
              nullable: true
              format: decimal
            total_ytd:
              type: number
              nullable: true
              format: decimal
        vacation_pay_balance:
          type: number
          description: >-
            The Employee's Vacation Pay balance as of the end of this pay
            period. `null` for Contractor pay stubs.
          nullable: true
          format: decimal
        liability:
          type: number
          description: >-
            The total amount owed by the company for this pay stub, including
            Employee or Contractor net pay, employer tax contributions, and
            employer benefit contributions.
          nullable: true
          format: decimal
        cash_requirement:
          type: number
          description: >-
            The total amount that will be debited from the company's account for
            this pay stub when the Payroll is approved.
          nullable: true
          format: decimal
        note:
          type: string
          description: An optional note on the pay stub, visible to the partner.
          nullable: true
        line_item_summary:
          type: object
          description: >-
            Totals grouped by line item category for this pay stub. Each
            category includes a `period` total for the current pay period and a
            `ytd` total for the calendar year to date. Categories: `earnings`,
            `statutory_withholdings`, `reimbursements`, `allowances`,
            `employee_benefits`, `employer_benefits`, `deductions`.
          nullable: true
          properties:
            earnings:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                period_managed:
                  type: number
                  nullable: true
                  format: decimal
                period_unmanaged:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            statutory_withholdings:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            reimbursements:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            allowances:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            benefits:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            employee_benefits:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            employer_benefits:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
            deductions:
              type: object
              nullable: true
              properties:
                period:
                  type: number
                  nullable: true
                  format: decimal
                ytd:
                  type: number
                  nullable: true
                  format: decimal
        is_stale:
          type: boolean
          description: >-
            Whether the pay stub's tax calculations are out of date. When
            `true`, `stale_since` indicates when the pay stub became stale.
        stale_since:
          type: string
          description: >-
            The timestamp at which the pay stub's tax calculations became stale
            and need to be recalculated. `null` if the pay stub is up to date.
          readOnly: true
          nullable: true
          format: dateTime
        warnings:
          type: object
          description: >-
            A collection of data validation warnings for this pay stub. Warnings
            indicate incomplete or potentially incorrect data and could prevent
            payroll processing.
          nullable: true
          properties:
            object:
              type: string
              nullable: true
            data:
              type: object
              nullable: true
        external_ref:
          type: string
          description: >-
            A reference to the object in an external system, e.g. the primary
            key of the object in your application's database. Nmbr doesn't use,
            validate, parse, or require this value to be unique - it simply
            stores it for your reference.
          nullable: true
          maxLength: 255
        apply_standard_tax_reductions:
          type: boolean
          description: >-
            When `true`, the standard tax reductions are applied to this pay
            stub's withholdings even in cases where they would otherwise be
            skipped to avoid applying them twice across related runs in the same
            period. In Canada these reductions are the employee's federal and
            provincial personal tax credits (their TD1 claim amounts) and the
            CPP/QPP basic exemption. Defaults to `false`, and has no effect
            where those reductions already apply.
        created_at:
          type: string
          description: The date and time the object was created in Nmbr.
          readOnly: true
          format: dateTime
        updated_at:
          type: string
          description: The date and time the object was last updated in Nmbr.
          readOnly: true
          format: dateTime
    Recurrence:
      type: object
    BusinessPreset:
      type: object
      title: Business Preset
      properties:
        business_entity:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"business_entity"`).
              readOnly: true
        name:
          type: string
          maxLength: 255
        name_translations:
          type: object
          description: Optional translations for the `name` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        name_translated:
          type: string
          description: >-
            The translation of the `name` property for the request locale.
            Computed using the values in `name` and `name_translations` and the
            value of the request's `Accept-Language` header.
          readOnly: true
        title:
          type: string
          nullable: true
        title_translations:
          type: object
          description: Optional translations for the `title` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        title_translated:
          type: string
          description: >-
            The translation of the `title` property for the request locale.
            Computed using the values in `title` and `title_translations` and
            the value of the request's `Accept-Language` header.
          readOnly: true
        type:
          type: string
          maxLength: 255
        subtype:
          type: string
          nullable: true
          maxLength: 255
        remittance_account: {}
        is_managed:
          type: boolean
          description: >-
            If true, this is a default Business Preset and can not be deleted,
            `title` and `remittance_account` may be set.
        expense_accounting_code: {}
        liability_accounting_code: {}
        income_basis:
          type: string
          nullable: true
          enum:
            - all_earnings
            - none
            - regular_earnings
            - total_income
        income_includes:
          type: object
          nullable: true
        external_ref:
          type: string
          description: >-
            A reference to the object in an external system, e.g. the primary
            key of the object in your application's database. Nmbr doesn't use,
            validate, parse, or require this value to be unique - it simply
            stores it for your reference.
          nullable: true
          maxLength: 255
        created_at:
          type: string
          description: The date and time the object was created in Nmbr.
          readOnly: true
          format: dateTime
        updated_at:
          type: string
          description: The date and time the object was last updated in Nmbr.
          readOnly: true
          format: dateTime
    SourceAdjustment:
      $ref: '#/components/schemas/Adjustment'
    ExpenseAccountingCode:
      $ref: '#/components/schemas/AccountingCode'
    ManagedExpenseAccountingCode:
      $ref: '#/components/schemas/AccountingCode'
    CustomExpenseAccountingCode:
      $ref: '#/components/schemas/AccountingCode'
    LiabilityAccountingCode:
      $ref: '#/components/schemas/AccountingCode'
    ManagedLiabilityAccountingCode:
      $ref: '#/components/schemas/AccountingCode'
    CustomLiabilityAccountingCode:
      $ref: '#/components/schemas/AccountingCode'
    TagAssignment:
      type: object
      properties:
        unit:
          type: string
          enum:
            - amount
            - hours
            - percentage
        tag_allocations:
          type: array
          items:
            type: object
            properties:
              tags:
                type: array
                items:
                  $ref: '#/components/schemas/Tag'
              value:
                type: number
                format: decimal
              expense_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
              liability_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
    ManagedTagAssignment:
      type: object
      properties:
        unit:
          type: string
          enum:
            - amount
            - hours
            - percentage
        tag_allocations:
          type: array
          items:
            type: object
            properties:
              tags:
                type: array
                items:
                  $ref: '#/components/schemas/Tag'
              value:
                type: number
                format: decimal
              expense_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
              liability_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
    CustomTagAssignment:
      type: object
      properties:
        unit:
          type: string
          enum:
            - amount
            - hours
            - percentage
        tag_allocations:
          type: array
          items:
            type: object
            properties:
              tags:
                type: array
                items:
                  $ref: '#/components/schemas/Tag'
              value:
                type: number
                format: decimal
              expense_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
              liability_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
    TagAssignmentAmount:
      type: object
      properties:
        unit:
          type: string
          enum:
            - amount
            - hours
            - percentage
        tag_allocations:
          type: array
          items:
            type: object
            properties:
              tags:
                type: array
                items:
                  $ref: '#/components/schemas/Tag'
              value:
                type: number
                format: decimal
              expense_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
              liability_accounting_code:
                $ref: '#/components/schemas/AccountingCode'
    ReimbursementType:
      type: object
      title: Reimbursement Type
      properties:
        type:
          type: string
          description: The string identifier for this reimbursement type.
          nullable: true
        label:
          type: string
          description: The human-readable display name for this reimbursement type.
          nullable: true
        features:
          type: array
          items:
            $ref: '#/components/schemas/LineItemTypeFeature'
        form_mappings:
          type: array
          items:
            $ref: '#/components/schemas/LineItemFormMapping'
    Translations:
      type: object
      nullable: true
      properties:
        en:
          type: string
          maxLength: 255
        fr:
          type: string
          maxLength: 255
    Adjustment:
      type: object
      title: Adjustment
      properties:
        source_line_item:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"earning_line_item"`).
              readOnly: true
            data:
              $ref: '#/components/schemas/LineItem'
        correction_line_item:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"earning_line_item"`).
              readOnly: true
            data:
              $ref: '#/components/schemas/LineItem'
        correction_pay_stub:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"pay_stub"`).
              readOnly: true
        type:
          type: string
          nullable: true
          maxLength: 255
        subtype:
          type: string
          nullable: true
          maxLength: 255
        expected_amount:
          type: number
          format: decimal
        admin_note:
          type: string
          nullable: true
        external_ref:
          type: string
          description: >-
            A reference to the object in an external system, e.g. the primary
            key of the object in your application's database. Nmbr doesn't use,
            validate, parse, or require this value to be unique - it simply
            stores it for your reference.
          nullable: true
          maxLength: 255
        created_at:
          type: string
          description: The date and time the object was created in Nmbr.
          readOnly: true
          format: dateTime
        updated_at:
          type: string
          description: The date and time the object was last updated in Nmbr.
          readOnly: true
          format: dateTime
    AccountingCode:
      type: object
      title: Accounting Code
      properties:
        business_entity:
          type: object
          description: The Business Entity this accounting code belongs to.
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"business_entity"`).
              readOnly: true
        type:
          type: string
          description: The type of accounting code.
          enum:
            - bank
            - expense
            - liability
        code:
          type: string
          description: >-
            The accounting code identifier as it appears in the chart of
            accounts.
          nullable: true
          maxLength: 255
        title:
          type: string
          maxLength: 255
        title_translations:
          type: object
          description: Optional translations for the `title` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        title_translated:
          type: string
          description: >-
            The translation of the `title` property for the request locale.
            Computed using the values in `title` and `title_translations` and
            the value of the request's `Accept-Language` header.
          readOnly: true
        description:
          type: string
          nullable: true
        description_translations:
          type: object
          description: Optional translations for the `description` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        description_translated:
          type: string
          description: >-
            The translation of the `description` property for the request
            locale. Computed using the values in `description` and
            `description_translations` and the value of the request's
            `Accept-Language` header.
          readOnly: true
        mapping:
          type: object
          nullable: true
          properties:
            xero:
              type: boolean
            quickbooks:
              type: boolean
        fallback_mappings:
          type: object
          description: >-
            Line Item type/subtype pairs that default to this accounting code
            when no specific mapping is configured. Each entry contains `type`
            and `subtype`.
          nullable: true
        created_at:
          type: string
          description: The date and time the object was created in Nmbr.
          readOnly: true
          format: dateTime
        updated_at:
          type: string
          description: The date and time the object was last updated in Nmbr.
          readOnly: true
          format: dateTime
    Tag:
      type: object
      title: Tag
      properties:
        label:
          type: string
          maxLength: 255
        label_translations:
          type: object
          description: Optional translations for the `label` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        label_translated:
          type: string
          description: >-
            The translation of the `label` property for the request locale.
            Computed using the values in `label` and `label_translations` and
            the value of the request's `Accept-Language` header.
          readOnly: true
        description:
          type: string
          nullable: true
        description_translations:
          type: object
          description: Optional translations for the `description` property.
          allOf:
            - $ref: '#/components/schemas/Translations'
          nullable: true
        description_translated:
          type: string
          description: >-
            The translation of the `description` property for the request
            locale. Computed using the values in `description` and
            `description_translations` and the value of the request's
            `Accept-Language` header.
          readOnly: true
        archived_at:
          type: string
          description: >-
            When set, the tag is archived and excluded from index listings by
            default.
          readOnly: true
          nullable: true
          format: dateTime
        is_deletable:
          type: boolean
          description: >-
            A tag may not be deleted while it is assigned to any active
            allocation.
        integrations:
          type: object
          description: >-
            Identifiers for this tag in external accounting integrations, used
            to sync tags imported from those systems.
          nullable: true
          properties:
            xero:
              type: object
              nullable: true
              properties:
                id:
                  type: string
                  description: The unique identifier of the object in Nmbr.
                  readOnly: true
                  maxLength: 32
            quickbooks:
              type: object
              nullable: true
              properties:
                id:
                  type: string
                  description: The unique identifier of the object in Nmbr.
                  readOnly: true
                  maxLength: 32
        tag_group:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"tag_group"`).
              readOnly: true
        business_entity:
          type: object
          properties:
            id:
              type: string
              description: The unique identifier of the object in Nmbr.
              readOnly: true
            object:
              type: string
              description: The type of the object in Nmbr (`"business_entity"`).
              readOnly: true
        created_at:
          type: string
          description: The date and time the object was created in Nmbr.
          readOnly: true
          format: dateTime
        updated_at:
          type: string
          description: The date and time the object was last updated in Nmbr.
          readOnly: true
          format: dateTime
    LineItemTypeFeature:
      type: object
      description: >-
        How this line item type affects a single payroll calculation, such as
        income tax or CPP. See [Line item type
        features](https://docs.nmbr.co/guides/payroll-fundamentals/line-item-type-features)
        for further details.
      properties:
        type:
          type: string
          description: The payroll calculation this entry describes.
          enum:
            - eht
            - income_tax
            - insurable
            - pensionable
            - vacationable
            - wcb
        label:
          type: string
          description: Human-readable name for the payroll calculation.
        definitions:
          type: array
          description: >-
            How this type affects the calculation, broken down by jurisdiction.
            Jurisdictions where it does not apply are omitted.
          items:
            type: object
            properties:
              jurisdiction:
                type: string
                description: >-
                  The jurisdiction this applies to (e.g. `ca_federal`, `ca_on`,
                  `ca_qc`).
              effects:
                type: array
                description: >-
                  How this type affects the payroll calculation in this
                  jurisdiction.
                items:
                  type: string
                  enum:
                    - accrues_vacation_pay
                    - reduces_base
                    - tax_credit
                    - withholding
              help_text:
                type: string
                description: >-
                  Plain-language explanation of how this type affects the
                  calculation in this jurisdiction.
                nullable: true
              program_label:
                type: string
                description: >-
                  The program that applies in this jurisdiction, for
                  calculations that use different programs by jurisdiction (e.g.
                  CPP federally, QPP in Quebec; EI federally, QPIP in Quebec).
                nullable: true
    LineItemFormMapping:
      type: object
      description: The year-end tax form boxes this line item type maps to.
      properties:
        form:
          type: string
          description: The form code (e.g. `t4`).
        form_label:
          type: string
          description: Human-readable form name.
        mapping:
          type: array
          description: The boxes on the form this type contributes to.
          items:
            type: array
            items:
              type: object
              properties:
                name:
                  type: string
                  description: The box or line identifier on the form.
                help_text:
                  type: string
                  description: Plain-language explanation of the box, when available.
                  nullable: true
    LineItem:
      type: object
  securitySchemes:
    CompanyToken:
      type: http
      scheme: bearer

````