Skip to main content
PATCH
Update customer

Authorizations

Authorization
string
header
required

An API key (ico_live_…), sent as Authorization: Bearer <key>. Not a JWT.

Path Parameters

id
string<uuid>
required

Body

application/json
name
string
Required string length: 1 - 255
email
string<email>
partner_id
string<uuid>
phone
string | null
Maximum string length: 50
address
object

Postal address of the business — required. It becomes the creditor address on the collection letters and on the court-fee invoice. Each line must be a non-empty string; a missing or empty line is a 400 VALIDATION_ERROR naming it (e.g. address.zip is required).

metadata
object | null

Your own key-value data, stored with the customer for incaseof.law. It is not returned by the API.

uid
string | null

EU VAT ID; null clears it

Maximum string length: 40
partner_client_reference
string | null

null clears it

Maximum string length: 255

The provider's legal form. German court filings need it.

Available options:
gmbh,
einzelunternehmen,
pauschalierter_land_forstwirt,
flexco,
eingetragener_kaufmann,
gbr,
og_ohg,
kg,
gmbh_co_kg,
ug,
ag,
se,
eg,
verein,
praktiker,
partg,
kgaa

Partner keys only. The provider's legal representative (gesetzlicher Vertreter), e.g. { "function": "Geschäftsführer", "name": "Dr. Anna Berger" } for a GmbH. For a sole trader (einzelunternehmen, eingetragener_kaufmann, praktiker, pauschalierter_land_forstwirt) send owner instead — a German court never takes the owner as the representative.

owner
object

Partner keys only. The owner of a sole trader.

billing_email
string<email>

Where invoices from incaseof.law to the provider go

vat_deductible
boolean

Whether the provider may deduct input VAT (Vorsteuerabzug). A German court filing declares it.

Response

Customer updated

success
boolean
Example:

true

data
object