API Reference

Endpoint

GET /v1/debt-collection/{debtCollectionRunId}/details

Path Parameters

debtCollectionRunId required integer (int64)

Unique ID of the debt collection run

Responses

Response Body application/json

Describes transfer details

collectionDate string(date)

Date when debt collection run was created

Example: "1952-05-04"

debtCollectionType

Type of debt collection

Allowed values:

`TRUST`	Claims are transferred, but still managed by the studio.
`PURCHASE`	Claims are transferred and bought by the debt collection agency.

Default: "TRUST"

Example: "TRUST"

client

The client matches a studio or location. The complete element should identify the person or company with its details of address, taxId, contact data and bank account information. An address should be complete, but only fields mandatory for all countries are marked as such

name1 required

Name first line

Example: "GYMLAB Hamburg"

name2

Name second line

Example: "GMBH"

legalForm

Legal form of the company

Example: "GmbH"

preTaxAttribute required

Possible to deduct tax up front

Default: "false"

Example: false

vatSerialNo

Tax ID of the client

Example: "DE 142156559"

postalCode required

Postal code of the client

Example: "1180"

city required

Cite code of the client

Example: "Vienna"

countryCode

Country code of the client, ISO Alpha-2

Example: "AT"

country

Country of the client

Example: "Australia"

paymentDetails

Describes the payment data.

accountNumber

Account number of the debtor

Example: "91 1000 0000 0123 4567 89"

bankCode

Bank code of the clients account

Example: "DE"

iban

Iban of the clients account

Example: "DE91 1000 0000 0123 4567 89"

bic

Bic of the clients account

Example: "DEUTDEFFXXX"

bank required

Bank name of the client

Example: "Deutsche Bank"

bankCountryCode

Bank country code of the client

Example: "DE"

accountHolder

The account holder of the bank account

Example: "Sven Hannawald"

contactDetails array[object]

List of contact details

type required

Type of contact data

Allowed values:

`TEL_PRIVATE`	Private phone number
`TEL_PRIVATE_MOBILE`	Private mobile phone number
`TEL_BUSINESS`	Business phone number
`TEL_BUSINESS_MOBILE`	Business mobile phone number
`FAX`	Fax number
`EMAIL`	Email address

Example: "TEL_BUSINESS"

value required

Value of contact data

Example: "s.hannawald@sportaliance.com"

status

Describes the status of the contact data.

type required

Type of contact status

Allowed values:

`NO_EMAIL`	No email provided.
`NOT_YET_USED`	Email is provided, but not yet used to send one.
`VALIDATION_IN_PROGRESS`	Email is provided, but currently under validation.
`VALID`	At least one Email was sent successfully.
`VALID_READ`	At least one Email was sent successfully and read.
`INVALID`	Email is provided, but bounced on delivery as invalid email address. No further emailing will happen.
`WARNING`	Email is provided, but bounced on delivery without a reason. Delivery will be tried again.
`REFUSED`	Email is provided, but bounced on delivery with a reason. Delivery will be tried again.
`REFUSED_FULL`	Email is provided, but bounced on delivery because the postbox is full. Delivery will be tried again.
`REFUSED_VIRUS`	Email is provided, but bounced on delivery because it failed the virus test. Delivery will be tried again.

Example: "VALID"

statusInformation

More details to the overall status

Example: "The mail server for the recipient domain does not accept messages to this address."

addressLine1

Address first line

Example: "Burgring 22"

addressLine2

Address second line

Example: "1180 Vienna"

addressLine3

Address third line

Example: "Austria"

region

Region of the client

Example: "Vienna"

addressData

Describes the address in detail, so every country has its own fields filled. Use addressLines for preformatted address.

street

Street of the client

Example: "Burgring"

houseNumber

House number of the client

Example: "23A"

addressStatus

Describes the status of the address.

type required

Type of address status

Allowed values:

`VALID`	Default status of an address.
`INVALID`	The address status is proven as invalid.

Example: "VALID"

statusInformation

More details on the overall status

Example: "Letter could not be delivered"

since string(date)

Current status unchanged since

Example: "2000-01-01"

status

Status of a Transfer

Allowed values:

`INTERNAL_PROCESSING`	The transfer is currently processed by Magicline.
`WAITING_FOR_CONFIRMATION`	Processing is done, the Agency should have received a Webhook Notification and should confirm retrieval of the Transfer.
`COMPLETED`	Processing is done and the Agency has confirmed the retrieval of the Transfer.
`FAILED`	At any of the previous stages an error occurred.

Example: "COMPLETED"

origin

Origin of debt collection

Allowed values:

`DEBT_COLLECTION_RUN`	Indicates that the debt was part of a regular or scheduled debt collection run.
`INDIVIDUAL_HANDOVER`	Indicates that the debt was handed over via an individual transfer in the member account.
`AUTOMATIC_HANDOVER`	Indicates that the debt was handed over automatically due to a MemberCash rejection.
`CONTRACT_CANCELATION`	Indicates that the debt was handed over alongside the manual cancellation of a contract.

Example: "DEBT_COLLECTION_RUN"

Validation of the request failed.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

TIMESTAMP BOOLEAN DATE MONTH_DAY TIME TERM TERM_LIST INTEGER DECIMAL STRING MONEY LIMITABLE_CONFIG_PROPERTY I18N_KEY I18N_KEY_LIST PERMISSION_LIST ENUM AVAILABILITY_LIST

reference

Reference to validation error

Example: "parent.child"

Authentication failed. No api-key, wrong api-key or wrong header name.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

reference

Reference to validation error

Example: "parent.child"

Authorization failed. The caller has no privilege to the given resource.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

reference

Reference to validation error

Example: "parent.child"

Entity does not exists.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

reference

Reference to validation error

Example: "parent.child"

Concurrent modification detected. The entity was modified by another request.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

reference

Reference to validation error

Example: "parent.child"

Access denied - rate limit is exceeded.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

reference

Reference to validation error

Example: "parent.child"

Unexpected system error.

Response Body application/json

Error data

errorMessage required

Resolved message in the context-specific default locale

errorCode

Key for translation files

traceId

Datadog trace id

args array[object] deprecated

Arguments referenced by format specifiers while resolving the message from translation files

typedArgs array[object] deprecated

Same as `args` but with type information

value

type

Allowed values:

reference

Reference to validation error

Example: "parent.child"