> ## Documentation Index
> Fetch the complete documentation index at: https://creditor-documentation.debbiecollect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get billing vouchers

> The fees (honorarer) and disbursements (udlæg) you are charged on a settlement — what you pay, next to what you are paid.

Only the fees that stand on their own are returned. A fee charged on a specific payment is part of that payment's distribution and is reported by [Get deposit distribution](/api-reference/endpoints/billings/deposit-distribution) as `collectionCommission` instead, so the two can be booked together without counting anything twice.

Together they are the whole settlement: without this endpoint, only half of the account is posted.

**Required scope:** `read:billings`



## OpenAPI

````yaml GET /v1/{tenantId}/billings/{billingId}/billing-vouchers
openapi: 3.1.0
info:
  title: Debbie Creditor API Docs
  description: >-
    The Debbie Creditor API is a RESTful interface allowing you, as a creditor,
    to programmatically send data to your debt collection partner and access
    your data in the platform. It provides predictable URLs for accessing
    resources, and uses built-in HTTP features to receive commands and return
    responses. This makes it easy to integrate with your own systems, for
    example your ERP or invoicing system.
  version: v1.0.0
  x-logo:
    url: https://debbie-platform.github.io/creditor-api-docs/deb-logo.svg
servers:
  - url: https://api.debbiecollect.com
security:
  - bearerAuth: []
tags:
  - name: Customers
    description: Endpoints for interacting with customers
  - name: Files
    description: Endpoints for interacting with files
  - name: Documents
    description: Endpoints for attaching documentation to a case or to your creditor
  - name: Direct payments
    description: Endpoints for registering payments made directly to you
  - name: Voucher types
    description: >-
      Endpoints for reading the voucher types available on your debt collection
      partner
  - name: Billings
    description: Endpoints for reading how a settlement is made up
externalDocs:
  description: Find out more about Debbie here
  url: https://debbiecollect.com
paths:
  /v1/{tenantId}/billings/{billingId}/billing-vouchers:
    get:
      tags:
        - Billings
      summary: Get billing vouchers
      description: >-
        The fees (honorarer) and disbursements (udlæg) you are charged on a
        settlement — what you pay, next to what you are paid.


        Only the fees that stand on their own are returned. A fee charged on a
        specific payment is part of that payment's distribution and is reported
        by [Get deposit
        distribution](/api-reference/endpoints/billings/deposit-distribution) as
        `collectionCommission` instead, so the two can be booked together
        without counting anything twice.


        Together they are the whole settlement: without this endpoint, only half
        of the account is posted.


        **Required scope:** `read:billings`
      operationId: billing-vouchers
      parameters:
        - in: path
          name: tenantId
          schema:
            type: string
            format: uuid
          required: true
          description: >-
            Id of your debt collection partner's tenant. You can find it on the
            API page in the creditor portal.
        - in: path
          name: billingId
          schema:
            type: string
            format: uuid
          required: true
          description: Id of the billing, from the `billings.create` webhook
        - in: query
          name: page
          schema:
            type: integer
            minimum: 0
            default: 0
          required: false
          description: Zero-based page number
        - in: query
          name: pageSize
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 25
          required: false
          description: Number of vouchers per page
        - in: query
          name: category
          schema:
            type: string
            example: '["fee","disbursement"]'
          required: false
          description: >-
            JSON encoded list of the categories to return, `fee` and/or
            `disbursement`. Omit to get both.
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      currentPage:
                        type: integer
                        example: 0
                      pageSize:
                        type: integer
                        example: 25
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/BillingVoucher'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '422':
          $ref: '#/components/responses/UnprocessableContent'
components:
  schemas:
    BillingVoucher:
      type: object
      properties:
        billingVoucherId:
          type: string
          format: uuid
          description: Id of the billing voucher
        id:
          type: integer
          description: Sequential id of the billing voucher
        category:
          type: string
          enum:
            - fee
            - disbursement
          description: >-
            Whether the entry is a fee charged by the collector or a
            disbursement laid out on the creditor's behalf
        voucherTypeId:
          type: string
          format: uuid
          description: Id of the voucher type
        label:
          type: string
          description: Display name of the voucher type
        amount:
          type: integer
          description: >-
            Amount in base currency, excluding VAT. For example 1.00 will be
            sent as 100.
        currency:
          $ref: '#/components/schemas/Currency'
        referenceId:
          type:
            - string
            - 'null'
          description: Reference id of the entry
        text:
          type:
            - string
            - 'null'
          description: Text on the entry
        vat:
          type: array
          description: The VAT charged on this entry. Empty when the entry carries no VAT.
          items:
            type: object
            properties:
              billingVoucherId:
                type: string
                format: uuid
                description: Id of the VAT billing voucher
              voucherTypeId:
                type: string
                format: uuid
                description: Id of the voucher type
              label:
                type: string
                description: Display name of the voucher type
              amount:
                type: integer
                description: Amount in base currency. For example 1.00 will be sent as 100.
        caseId:
          type: string
          format: uuid
          description: Id of the case the entry belongs to
        caseSequentialId:
          type:
            - integer
            - 'null'
          description: Sequential id of the case the entry belongs to
        creditorId:
          type:
            - string
            - 'null'
          format: uuid
          description: Id of the creditor being charged
        creditorName:
          type:
            - string
            - 'null'
          description: Name of the creditor being charged
        creditorReferenceId:
          type:
            - string
            - 'null'
          description: Your own id for the creditor
        billingId:
          type:
            - string
            - 'null'
          format: uuid
          description: Id of the billing the entry is settled on
        billingAppendixId:
          type:
            - string
            - 'null'
          format: uuid
          description: Id of the settlement appendix the entry belongs to
        createdAt:
          type: string
          description: Created at timestamp of the entry
        createdBy:
          type:
            - object
            - 'null'
          description: Actor that created the entry
          properties:
            id:
              type: string
              format: uuid
              description: Id of the actor
            type:
              type: string
              description: Type of the actor
        caseVoucher:
          type:
            - object
            - 'null'
          description: The case voucher the entry relates to, when it relates to one
        depositCaseVoucher:
          type:
            - object
            - 'null'
          description: The deposit the entry relates to, when it relates to one
    Currency:
      type: string
      enum:
        - DKK
        - SEK
        - NOK
        - USD
        - EUR
        - GBP
        - CHF
      description: Currency
  responses:
    UnauthorizedError:
      description: Access token missing or invalid
    UnprocessableContent:
      description: Unable to process the contained instructions.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authentication with an API key can be done by using a bearer token in
        the Authorization header. This is done using the following format
        `Authorization: Bearer {token}`. API keys are issued and revoked
        directly from the creditor portal under Developers > API.

````