curl --request POST \
  --url https://api.debbiecollect.com/v1/{tenantId}/case-vouchers/allocations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
  "date": "2026-06-04",
  "currency": "DKK",
  "matches": [
    {
      "caseVoucherReferenceId": "D12412347",
      "amount": 100000
    },
    {
      "caseVoucherReferenceId": "D12412348",
      "amount": 20000
    },
    {
      "caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
      "amount": 30000
    }
  ]
}
'

[
  {
    "caseId": "3f1c2d4e-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "caseVoucherId": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "amount": 120000,
    "currency": "DKK",
    "date": "2026-06-04T00:00:00.000Z",
    "voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
    "targetCaseVouchers": [
      {
        "caseVoucherId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
        "referenceId": "D12412347",
        "amount": -120000,
        "matchedAmount": 100000
      },
      {
        "caseVoucherId": "426148d2-204a-414b-8c76-cab1261c9b98",
        "referenceId": "D12412348",
        "amount": -20000,
        "matchedAmount": 20000
      }
    ]
  },
  {
    "caseId": "92dd77da-9098-41f0-9568-01e8e5f8b603",
    "caseVoucherId": "0ba4a63e-e4c5-4aae-8ab7-0d3d6e0c89ad",
    "amount": 30000,
    "currency": "DKK",
    "date": "2026-06-04T00:00:00.000Z",
    "voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
    "targetCaseVouchers": [
      {
        "caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
        "referenceId": "D12412349",
        "amount": -30000,
        "matchedAmount": 30000
      }
    ]
  }
]

Case voucher allocations

Register case voucher allocation

Register a payment made directly to the creditor or a credit note against a list of existing case vouchers. Set voucherTypeId to deposit or credit note; other types are currently rejected. All created vouchers use source CREDITOR.

Each item in matches supplies a positive amount in minor units and exactly one of caseVoucherId and caseVoucherReferenceId. References must be unambiguous within the supplied creditorId. A target may appear only once, including when supplied by ID and reference in different items. Each amount must fit within the target’s remaining fixed-distribution capacity. All targets must have the same currency.

Matches are grouped by case. One allocation voucher is created per case with the sum of that case’s match amounts, and one fixed distribution per target on both accounts, using the allocation voucher date. No fixed distribution crosses cases. The response is an array of the created allocation vouchers and their targetCaseVouchers, including each matchedAmount.

Required scope: write:case-vouchers

POST

{tenantId}

case-vouchers

allocations

curl --request POST \
  --url https://api.debbiecollect.com/v1/{tenantId}/case-vouchers/allocations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
  "date": "2026-06-04",
  "currency": "DKK",
  "matches": [
    {
      "caseVoucherReferenceId": "D12412347",
      "amount": 100000
    },
    {
      "caseVoucherReferenceId": "D12412348",
      "amount": 20000
    },
    {
      "caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
      "amount": 30000
    }
  ]
}
'

[
  {
    "caseId": "3f1c2d4e-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
    "caseVoucherId": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "amount": 120000,
    "currency": "DKK",
    "date": "2026-06-04T00:00:00.000Z",
    "voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
    "targetCaseVouchers": [
      {
        "caseVoucherId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
        "referenceId": "D12412347",
        "amount": -120000,
        "matchedAmount": 100000
      },
      {
        "caseVoucherId": "426148d2-204a-414b-8c76-cab1261c9b98",
        "referenceId": "D12412348",
        "amount": -20000,
        "matchedAmount": 20000
      }
    ]
  },
  {
    "caseId": "92dd77da-9098-41f0-9568-01e8e5f8b603",
    "caseVoucherId": "0ba4a63e-e4c5-4aae-8ab7-0d3d6e0c89ad",
    "amount": 30000,
    "currency": "DKK",
    "date": "2026-06-04T00:00:00.000Z",
    "voucherTypeId": "c51f2f6a-8081-45ef-b52d-5e0569fdf12e",
    "targetCaseVouchers": [
      {
        "caseVoucherId": "d341b682-c7b2-48b4-9152-17c3b4085089",
        "referenceId": "D12412349",
        "amount": -30000,
        "matchedAmount": 30000
      }
    ]
  }
]

Authorizations

Authorization

string

header

required

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.

Path Parameters

tenantId

string<uuid>

required

Id of your debt collection partner's tenant. You can find it on the API page in the creditor portal.

Query Parameters

creditorId

string<uuid>

required

Your creditor id. You can find it on the API page in the creditor portal.

Body

application/json

The creditor allocation

One payment or credit note allocated across one or more case vouchers. All matches are validated and saved in one transaction. There is no separate total amount: each created voucher is the sum of its case's match amounts.

voucherTypeId

enum<string>

required

Type of the new allocation voucher: deposit (c51f2f6a-8081-45ef-b52d-5e0569fdf12e) or credit note (ef2cdc50-230f-4046-b1af-0f9c498dddd3).

Available options:

c51f2f6a-8081-45ef-b52d-5e0569fdf12e,

ef2cdc50-230f-4046-b1af-0f9c498dddd3

matches

object[]

required

Allocations to existing debt vouchers belonging to the supplied creditor. Targets may belong to different cases, but must use the same currency. Amounts are summed per case to create one allocation voucher per case.

Minimum array length: 1

One target case voucher and the positive amount to apply to it in minor units. Give exactly one of caseVoucherId and caseVoucherReferenceId; the unused identifier may be absent or null. A target may only occur once, including when identified by both its ID and reference in separate matches.

Option 1
Option 2

Show child attributes

date

Date of the payment or credit note: YYYY-MM-DD or an ISO 8601 timestamp with Z or a timezone offset (for example, 2026-09-21T12:34:56+02:00). Defaults to now. Invalid calendar dates and timestamps without a timezone are rejected.

currency

enum<string>

Optional currency assertion. When omitted, the first target determines the currency. All targets must use that currency; mixed-currency requests are rejected.

Available options:

DKK,

SEK,

NOK,

USD,

EUR,

GBP,

CHF

text

string

Free text shown on the created allocation voucher.

Response

All allocations were registered. Returns one allocation voucher per case.

caseId

string<uuid>

required

Id of the case the allocation was registered on

caseVoucherId

string<uuid>

required

Id of the created payment or credit note voucher

amount

integer

required

Sum of the matchedAmount values on this case, in minor units.

currency

enum<string>

required

Currency

Available options:

DKK,

SEK,

NOK,

USD,

EUR,

GBP,

CHF

date

string

required

voucherTypeId

enum<string>

required

Type of the new allocation voucher: deposit (c51f2f6a-8081-45ef-b52d-5e0569fdf12e) or credit note (ef2cdc50-230f-4046-b1af-0f9c498dddd3).

Available options:

c51f2f6a-8081-45ef-b52d-5e0569fdf12e,

ef2cdc50-230f-4046-b1af-0f9c498dddd3

targetCaseVouchers

object[]

required

Only targets on this case, with their allocated amounts.

Minimum array length: 1

Show child attributes

API Documentation

Customers

Case voucher allocations

Files

Documents

Voucher types

Billings

Webhooks

Register case voucher allocation

Authorizations

Path Parameters

Query Parameters

Body

Response