Skip to main content
GET
Get an invoice service by external id
Retrieve a Service to track where it stands after activation – whether funding is in progress, complete, or was not activated.
An accepted financing service includes the advance paid to the merchant, the fees, and any holdback (security). advance.rate is the share of the invoice face that was paid out. It can be lower than the configured advance rate when fees cap the payout, and it is omitted when the service was accepted before the advance was locked.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Response

external_id
string
required
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
invoice_external_id
string
required
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
service_type
enum<string>
required
Available options:
FINANCING,
INSURANCE,
COLLECTION
status
enum<string>
required
Available options:
IN_REVIEW,
ACCEPTED,
REJECTED,
CANCELLED,
PAID_OUT,
SETTLED,
DEFAULTED,
CLAIM_NOTIFIED,
CLAIM_IN_ASSESSMENT,
CLAIM_PAID,
CLAIM_DENIED,
COVER_EXPIRED,
EARLY_COLLECTION,
LATE_COLLECTION,
COLLECTED,
UNCOLLECTIBLE
created_at
number
required
updated_at
number
required
requirements
object[]
advance
object

Advance amount paid out to the merchant for this invoice. Each invoice receives its own SEPA transfer, with the invoice number leading the remittance information for startsWith reconciliation.

fee
object

Fees applied to this invoice, in the smallest currency unit. gross = net + tax.

security
object

Holdback on this financing service.