---
title: "Submit one invoice for collection"
method: POST
path: "/collection-requests"
tags: ["CollectionRequests"]
---

# Submit one invoice for collection

`POST /collection-requests`

## Request

- Base URL: `https://referral-api.debitura.com`
- URL: `https://referral-api.debitura.com/collection-requests`
- Auth: API key in header `XApiKey`

Available only when Starter Integration is enabled. Send exactly one invoice in the invoices array. Return navigation uses the referral partner configuration; no per-request returnUrl is supported. Client details are used only on creation; existing clients approve a new connection. solutionUrl points to the first outstanding action: onboarding, approval, signature, KYC, fixing drafts, then the case. Resubmitting a client invoice reference returns its existing case within the same data classification.

## Headers

- `Idempotency-Key` string

## Request body

- DebituraWebReferralPartnerApiModelsCollectionRequestsCreateCollectionRequestRequest
  - `externalTenantId` string, nullable
  - `client` DebituraDomainModelReferralPartnersStoredClientDetailsDto
    - `name` string, nullable
    - `registrationNumber` string, nullable
    - `address` string, nullable
    - `zipCode` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `country` string, nullable
    - `supportEmail` string, nullable
    - `supportPhone` string, nullable
  - `user` DebituraWebReferralPartnerApiModelsCollectionRequestsStarterUserRequest
    - `name` string, nullable
    - `email` string, nullable
  - `invoices` DebituraWebReferralPartnerApiModelsCollectionRequestsStarterInvoiceRequest[], nullable
    - `currencyCode` string, nullable
    - `date` string, date-time, nullable
    - `dueDate` string, date-time, nullable
    - `comments` string, nullable
    - `claimDescription` string, nullable
    - `creditorReference` string, nullable
    - `debtor` DebituraDomainModelReferralPartnersCollectionRequestsCollectionRequestDraftDebtor
      - `type` string, nullable
      - `name` string, nullable
      - `contactPerson` string, nullable
      - `companyRegistrationNumber` string, nullable
      - `address` string, nullable
      - `zipCode` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `stateAlpha2` string, nullable
      - `countryAlpha2` string, nullable
      - `country` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
    - `creditorDivisionId` string, uuid, nullable
    - `amountToRecover` number, double, nullable
    - `amountToRecoverOver6Months` number, double, nullable
    - `amountToRecoverOver12Months` number, double, nullable
    - `amountToRecoverOver24Months` number, double, nullable
    - `claimLines` DebituraWebExternalApiContractsV1CasesRequestsClaimLineDto[], nullable
      - `dueDate` string, date-time, nullable, required: Payment deadline of this invoice. Provide date only without time component. Must be on or after 2000-01-01 and must not be in the future.
      - `amount` number, double, required: The outstanding balance on this invoice in the case currency — what the debtor still owes on it, already net of any payments the debtor has made and net of any credit notes issued against it. This is not the invoice's original face value. Must be greater than zero with at most 2 decimal places; omit invoices that are fully settled.
      - `reference` string, nullable: Optional: your own invoice number for this line. Used only to make validation errors readable and to reject the same invoice being sent twice. It is not stored and not shown to anyone.
    - `isTest` boolean
    - `tag` string, nullable

## Response `201`

Created

- DebituraDomainModelReferralPartnersCollectionRequestsCollectionRequestResponse
  - `id` string, uuid
  - `status` 'awaiting_onboarding' | 'awaiting_approval' | 'awaiting_signature' | 'awaiting_kyc' | 'needs_fixing' | 'submitted' | 'rejected' | 'expired' | 'processing'
  - `solutionUrl` string, nullable
  - `solutionType` 'onboarding' | 'approval' | 'sdca' | 'sdca_update' | 'power_of_attorney' | 'jurisdiction_pricing_appendix' | 'kyc' | 'fix' | 'case' | 'signature', nullable: Next action: onboarding, approval, sdca (initial/fallback SDCA), sdca_update, power_of_attorney, jurisdiction_pricing_appendix, kyc, fix or case. Null when no action is available. Status remains awaiting_signature for agreement work. The legacy signature value can appear only in an immutable keyed replay snapshot.
  - `externalTenantId` string, nullable
  - `client` DebituraDomainModelReferralPartnersCollectionRequestsCollectionRequestClientResponse
    - `debituraClientId` string, uuid, nullable
    - `isNew` boolean
    - `isAttributedClient` boolean
  - `invoices` DebituraDomainModelReferralPartnersCollectionRequestsCollectionRequestInvoiceResponse[], nullable
    - `creditorReference` string, nullable
    - `status` 'waiting' | 'draft' | 'created' | 'rejected'
    - `caseId` string, uuid, nullable
    - `draftId` string, uuid, nullable
    - `caseStatus` string, nullable
    - `reason` string, nullable
    - `issues` DebituraDomainModelReferralPartnersCollectionRequestsCollectionRequestIssue[], nullable
      - `field` string, nullable
      - `type` string, nullable
      - `message` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `202`: Accepted
- `422`: Unprocessable Content

## Changes

- **2026-11-03** `cf12c7f270d9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/changes/collection-requests/post.md)

---

[API](https://skmtc.dev/debitura/apis/debitura-referral-partner-api.md) - [All operations](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/debitura/apis/debitura-referral-partner-api/revisions/cf12c7f270d9?raw)