Candis Reimbursements API

The Reimbursements API from Candis — 1 operation(s) for reimbursements.

Operations 1

GET /v1/organizations/{organizationId}/reimbursement-items List reimbursement items of the organization #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/candis-reimbursements-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

candis-reimbursements-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Candis Core Data Reimbursements API
  description: Candis API for exporting approved invoices and postings, managing master core data (contacts, general ledger accounts, cost dimensions, delivery costs), and reading invoice, reimbursement item, and purchase request data. Reconstructed by the API Evangelist enrichment pipeline from the per-operation OpenAPI fragments embedded in the Candis ReadMe developer reference (developer.candis.io).
  version: 1.0.0
  contact:
    name: Candis
    url: https://developer.candis.io/
  x-apievangelist:
    method: searched
    source: Reconstructed from per-operation OpenAPI fragments published in the Candis developer reference (https://developer.candis.io/reference/*) via ReadMe; merged and filtered to Candis /v1/organizations operations by the API Evangelist enrichment pipeline.
    generated: '2026-07-18'
servers:
- url: https://api.candis.io
  description: Production
security:
- bearerAuth: []
tags:
- name: Reimbursements
paths:
  /v1/organizations/{organizationId}/reimbursement-items:
    get:
      operationId: listReimbursementItems
      summary: List reimbursement items of the organization
      parameters:
      - name: organizationId
        required: true
        in: path
        description: The organization ID.
        example: alpha-organization
        schema:
          type: string
      - name: offset
        required: false
        in: query
        description: The offset of the first element in the list.
        example: 0
        schema:
          minimum: 0
          default: 0
          type: number
      - name: limit
        required: false
        in: query
        description: The maximum number of elements to return.
        example: 50
        schema:
          minimum: 1
          default: 50
          type: number
      - name: sortField
        required: false
        in: query
        description: The field to sort by.
        example: REIMBURSEMENT_ITEM_DATE
        schema:
          enum:
          - REIMBURSEMENT_ITEM_DATE
          - UPDATED_AT
          type: string
      - name: sortDirection
        required: false
        in: query
        description: The direction to sort by.
        example: ASC
        schema:
          enum:
          - ASC
          - DESC
          type: string
      - name: status
        required: false
        in: query
        description: Current status of the reimbursement item. Comma separated values.
        example: EXPORTED
        schema:
          enum:
          - APPROVED
          - EXPORTED
          type: string
      - name: types
        required: false
        in: query
        description: Type of the reimbursement item. Comma separated values.
        example: GENERAL_EXPENSE
        schema:
          enum:
          - GENERAL_EXPENSE
          - HOSPITALITY_EXPENSE
          - PER_DIEM
          - MILEAGE
          type: string
      - name: reimbursementItemDateFrom
        required: false
        in: query
        description: From date and time for reimbursement item date.
        example: '2024-01-01T12:00:00Z'
        schema:
          type: string
      - name: reimbursementItemDateTo
        required: false
        in: query
        description: To date and time for reimbursement item date.
        example: '2024-01-01T12:00:00Z'
        schema:
          type: string
      - name: updatedAtFrom
        required: false
        in: query
        description: From date and time when the reimbursement item was updated.
        example: '2024-01-01T12:00:00Z'
        schema:
          type: string
      - name: updatedAtTo
        required: false
        in: query
        description: To date and time when the reimbursement item was updated.
        example: '2024-01-01T12:00:00Z'
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  reimbursementItems:
                    type: array
                    description: Records of reimbursement items.
                    items:
                      oneOf:
                      - title: Hospitality Expense
                        type: object
                        properties:
                          id:
                            type: string
                            description: Unique identifier of the reimbursement item.
                            example: 8341a018-6196-47cb-8fa2-3ad40983be24
                          status:
                            type: string
                            enum:
                            - APPROVED
                            - EXPORTED
                          createdAt:
                            type: string
                            description: Created at.
                            example: '2024-01-01T12:00:00Z'
                          updatedAt:
                            type: string
                            description: Updated at.
                            example: '2024-01-01T12:00:00Z'
                          title:
                            type: string
                            description: Title of the reimbursement item.
                            example: Reimbursement Item Title
                          totalAmount:
                            description: Total amount of the reimbursement item.
                            example: 10000
                            allOf:
                            - type: object
                              properties:
                                amount:
                                  type: number
                                  description: Original amount before currency conversion
                                currency:
                                  type: string
                                  description: Original currency before conversion to base currency
                                baseAmount:
                                  type:
                                  - number
                                  - 'null'
                                  description: Amount after currency conversion to base currency (EUR)
                                baseCurrency:
                                  type:
                                  - string
                                  - 'null'
                                  description: Base currency for conversion
                                exchangeRate:
                                  type:
                                  - number
                                  - 'null'
                                  description: Exchange rate used for currency conversion
                                exchangeRateDate:
                                  type:
                                  - string
                                  - 'null'
                                  description: Date for exchange rate calculation
                              required:
                              - amount
                              - currency
                          reimbursementCase:
                            description: Reimbursement item case.
                            allOf:
                            - type: object
                              properties:
                                id:
                                  type: string
                                  description: Unique identifier of the reimbursement item case.
                                  example: 8341a018-6196-47cb-8fa2-3ad40983be24
                                title:
                                  type: string
                                  description: Title of the reimbursement item case.
                                  example: Reimbursement Item Case Title
                                submittedForReviewAt:
                                  type: string
                                  description: Submitted for review at.
                                  example: '2024-01-01T12:00:00Z'
                              required:
                              - id
                              - title
                              - submittedForReviewAt
                          contact:
                            description: Contact of the reimbursement item.
                            allOf:
                            - type: object
                              properties:
                                name:
                                  type: string
                                  description: Contact name
                                  example: John Doe
                                accountsPayableNumber:
                                  type:
                                  - string
                                  - 'null'
                                  description: Contact payable number
                                  example: K1349234
                                paymentInfo:
                                  type: object
                                  properties:
                                    iban:
                                      type: string
                                      description: IBAN
                                      example: DE12345678901234567890
                                    swiftCode:
                                      type:
                                      - string
                                      - 'null'
                                      description: SWIFT code
                                      example: BIC123456789
                                    bankAccountNumber:
                                      type:
                                      - string
                                      - 'null'
                                      description: Bank account number
                                      example: '1234567890'
                                    accountHolder:
                                      type:
                                      - string
                                      - 'null'
                                      description: Account holder
                                      example: John Doe
                                  required:
                                  - iban
                          bookings:
                            description: Bookings of the reimbursement item.
                            type: array
                            items:
                              type: object
                              properties:
                                dueDate:
                                  type:
                                  - string
                                  - 'null'
                                  description: Discount payment date
                                  example: '2022-09-15T22:00:00.000Z'
                                amount:
                                  type: number
                                  description: Amount in original currency.
                                  example: 2784
                                baseAmount:
                                  type:
                                  - number
                                  - 'null'
                                  description: Amount in base currency (EUR).
                                  example: 2784
                                costCenter:
                                  description: Cost center
                                  allOf:
                                  - type: object
                                    properties:
                                      code:
                                        type: string
                                        example: KOST2
                                      name:
                                        type: string
                                        example: booking-1-cs-2-name
                                    required:
                                    - code
                                costObject:
                                  description: Cost object
                                  allOf:
                                  - type: object
                                    properties:
                                      code:
                                        type: string
                                        example: KOST2
                                      name:
                                        type: string
                                        example: booking-1-cs-2-name
                                    required:
                                    - code
                                generalLedgerAccount:
                                  description: General ledger account
                                  allOf:
                                  - type: object
                                    properties:
                                      accountCode:
                                        type: string
                                        description: General ledger account code
                                        example: '1100'
                                      name:
                                        type: string
                                        description: General ledger account name
                                        example: electricity
                                    required:
                                    - accountCode
                                    - name
                                extraCostInfo:
                                  description: Extra cost info
                                  allOf:
                                  - type: object
                                    properties:
                                      code:
                                        type: string
                                        example: KOST2
                                      name:
                                        type: string
                                        example: booking-1-cs-2-name
                                    required:
                                    - code
                                artistSocialInsuranceCode:
                                  type:
                                  - string
                                  - 'null'
                                  description: Artist social insurance code.
                                  example: W
                                bookingKey:
                                  description: Booking key
                                  allOf:
                                  - type: object
                                    properties:
                                      taxCode:
                                        type: string
                                        description: Tax Code
                                        example: '40'
                                      description:
                                        type: string
                                        description: Tax code description
                                        example: Tax Code 40
                                    required:
                                    - taxCode
                                    - description
                                vatRate:
                                  type:
                                  - number
                                  - 'null'
                                  description: Vat rate
                                note:
                                  type:
                                  - string
                                  - 'null'
                                  description: Note
                                  example: This is a note.
                                postingText:
                                  type:
                                  - string
                                  - 'null'
                                  description: Posting text
                                  example: This is a posting text.
                              required:
                              - amount
                          invoiceNumber:
                            type: string
                            description: Invoice number of the reimbursement item.
                            example: '1234567890'
                          expenseDate:
                            type: string
                            description: Expense date of the reimbursement item.
                            example: '2024-01-01T12:00:00Z'
                          type:
                            type: string
                            enum:
                            - HOSPITALITY_EXPENSE
                          location:
                            type:
                            - string
                            - 'null'
                            description: Location of the reimbursement item.
                            example: Berlin
                          internalGuests:
                            description: Internal guests of the reimbursement item.
                            example:
                            - John Doe
                            - Jane Doe
                            type:
                            - array
                            - 'null'
                            items:
                              type: string
                          externalGuests:
                            description: External guests of the reimbursement item.
                            example:
                            - John Doe
                            - Jane Doe
                            type:
                            - array
                            - 'null'
                            items:
                              type: string
                          tipAmount:
                            description: Tip amount of the reimbursement item.
                            example: 10000
                            allOf:
                            - type: object
                              properties:
                                amount:
                                  type: number
                                  description: Original amount before currency conversion
                                currency:
                                  type: string
                                  description: Original currency before conversion to base currency
                                baseAmount:
                                  type:
                                  - number
                                  - 'null'
                                  description: Amount after currency conversion to base currency (EUR)
                                baseCurrency:
                                  type:
                                  - string
                                  - 'null'
                                  description: Base currency for conversion
                                exchangeRate:
                                  type:
                                  - number
                                  - 'null'
                                  description: Exchange rate used for currency conversion
                                exchangeRateDate:
                                  type:
                                  - string
                                  - 'null'
                                  description: Date for exchange rate calculation
                              required:
                              - amount
                              - currency
                          receiptAmount:
                            description: Receipt amount of the reimbursement item.
                            example: 10000
                            allOf:
                            - type: object
                              properties:
                                amount:
                                  type: number
                                  description: Original amount before currency conversion
                                currency:
                                  type: string
                                  description: Original currency before conversion to base currency
                                baseAmount:
                                  type:
                                  - number
                                  - 'null'
                                  description: Amount after currency conversion to base currency (EUR)
                                baseCurrency:
                                  type:
                                  - string
                                  - 'null'
                                  description: Base currency for conversion
                                exchangeRate:
                                  type:
                                  - number
                                  - 'null'
                                  description: Exchange rate used for currency conversion
                                exchangeRateDate:
                                  type:
                                  - string
                                  - 'null'
                                  description: Date for exchange rate calculation
                              required:
                              - amount
                              - currency
                        required:
                        - id
                        - status
                        - createdAt
                        - updatedAt
                        - title
                        - totalAmount
                        - reimbursementCase
                        - contact
                        - bookings
                        - invoiceNumber
                        - expenseDate
                        - type
                        - receiptAmount
                      - title: General Expense
                        type: object
                        properties:
                          id:
                            type: string
                            description: Unique identifier of the reimbursement item.
                            example: 8341a018-6196-47cb-8fa2-3ad40983be24
                          status:
                            type: string
                            enum:
                            - APPROVED
                            - EXPORTED
                          createdAt:
                            type: string
                            description: Created at.
                            example: '2024-01-01T12:00:00Z'
                          updatedAt:
                            type: string
                            description: Updated at.
                            example: '2024-01-01T12:00:00Z'
                          title:
                            type: string
                            description: Title of the reimbursement item.
                            example: Reimbursement Item Title
                          totalAmount:
                            description: Total amount of the reimbursement item.
                            example: 10000
                            allOf:
                            - type: object
                              properties:
                                amount:
                                  type: number
                                  description: Original amount before currency conversion
                                currency:
                                  type: string
                                  description: Original currency before conversion to base currency
                                baseAmount:
                                  type:
                                  - number
                                  - 'null'
                                  description: Amount after currency conversion to base currency (EUR)
                                baseCurrency:
                                  type:
                                  - string
                                  - 'null'
                                  description: Base currency for conversion
                                exchangeRate:
                                  type:
                                  - number
                                  - 'null'
                                  description: Exchange rate used for currency conversion
                                exchangeRateDate:
                                  type:
                                  - string
                                  - 'null'
                                  description: Date for exchange rate calculation
                              required:
                              - amount
                              - currency
                          reimbursementCase:
                            description: Reimbursement item case.
                            allOf:
                            - type: object
                              properties:
                                id:
                                  type: string
                                  description: Unique identifier of the reimbursement item case.
                                  example: 8341a018-6196-47cb-8fa2-3ad40983be24
                                title:
                                  type: string
                                  description: Title of the reimbursement item case.
                                  example: Reimbursement Item Case Title
                                submittedForReviewAt:
                                  type: string
                                  description: Submitted for review at.
                                  example: '2024-01-01T12:00:00Z'
                              required:
                              - id
                              - title
                              - submittedForReviewAt
                          contact:
                            description: Contact of the reimbursement item.
                            allOf:
                            - type: object
                              properties:
                                name:
                                  type: string
                                  description: Contact name
                                  example: John Doe
                                accountsPayableNumber:
                                  type:
                                  - string
                                  - 'null'
                                  description: Contact payable number
                                  example: K1349234
                                paymentInfo:
                                  type: object
                                  properties:
                                    iban:
                                      type: string
                                      description: IBAN
                                      example: DE12345678901234567890
                                    swiftCode:
                                      type:
                                      - string
                                      - 'null'
                                      description: SWIFT code
                                      example: BIC123456789
                                    bankAccountNumber:
                                      type:
                                      - string
                                      - 'null'
                                      description: Bank account number
                                      example: '1234567890'
                                    accountHolder:
                                      type:
                                      - string
                                      - 'null'
                                      description: Account holder
                                      example: John Doe
                                  required:
                                  - iban
                          bookings:
                            description: Bookings of the reimbursement item.
                            type: array
                            items:
                              type: object
                              properties:
                                dueDate:
                                  type:
                                  - string
                                  - 'null'
                                  description: Discount payment date
                                  example: '2022-09-15T22:00:00.000Z'
                                amount:
                                  type: number
                                  description: Amount in original currency.
                                  example: 2784
                                baseAmount:
                                  type:
                                  - number
                                  - 'null'
                                  description: Amount in base currency (EUR).
                                  example: 2784
                                costCenter:
                                  description: Cost center
                                  allOf:
                                  - type: object
                                    properties:
                                      code:
                                        type: string
                                        example: KOST2
                                      name:
                                        type: string
                                        example: booking-1-cs-2-name
                                    required:
                                    - code
                                costObject:
                                  description: Cost object
                                  allOf:
                                  - type: object
                                    properties:
                                      code:
                                        type: string
                                        example: KOST2
                                      name:
                                        type: string
                                        example: booking-1-cs-2-name
                                    required:
                                    - code
                                generalLedgerAccount:
                                  description: General ledger account
                                  allOf:
                                  - type: object
                                    properties:
                                      accountCode:
                                        type: string
                                        description: General ledger account code
                                        example: '1100'
                                      name:
                                        type: string
                                        description: General ledger account name
                                        example: electricity
                                    required:
                                    - accountCode
                                    - name
                                extraCostInfo:
                                  description: Extra cost info
                                  allOf:
                                  - type: object
                                    properties:
                                      code:
                                        type: string
                                        example: KOST2
                                      name:
                                        type: string
                                        example: booking-1-cs-2-name
                                    required:
                                    - code
                                artistSocialInsuranceCode:
                                  type:
                                  - string
                                  - 'null'
                                  description: Artist social insurance code.
                                  example: W
                                bookingKey:
                                  description: Booking key
                                  allOf:
               

# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/candis/refs/heads/main/openapi/candis-reimbursements-api-openapi.yml