Update a Legal entity

put

https://api-mtls.eu.tispayments.com/rest/api/bam/legal-entities/{legalEntityId}

Use this endpoint to update the details of an existing Legal entity by specifying its unique identifier. Provide all valid and available Legal entity fields in the request body. Any fields omitted from the request will be lost or overwritten with TIS default values.

Path Params

legalEntityId

string

required

Unique UUID identifier of the Legal entity

Body Params

businessId

string

length ≤ 32

External identifier that can be used to link the bank entity in TIS to an entity in a third party system. Optional field. Alphanumeric, up to a maximum of 32 characters. If not specified, it will be automatically generated in TIS in the following format "LE_XXXXXXXX". The field is editable.

name

string

required

length ≤ 255

A name of the Legal entity. Required field. Supports alphanumeric value, up to 255 characters.

address

string

length ≤ 255

Address of the Legal entity. Optional field. Supports alphanumeric value, up to 255 characters.

zipCode

string

length ≤ 64

Postal code of the Legal entity. Optional field. Supports alphanumeric value, up to 64 characters.

city

string

length ≤ 64

City of the legal entity. Optional field. Supports alphanumeric value, up to a maximum of 64 characters.

country

string

length ≤ 2

ISO 3166-1 alpha-2 code

state

string

length ≤ 5

State of the Legal entity. Optional field. Support 3166-2 code values in the following format Country ISO 3166-1 two-character code and a string of up to three alphanumeric country-specific subdivision codes.

language

string

length ≤ 4

Correspondence language. Optional field. Support predefined set of values, represented as 4 characters code ISO 639-1 language code and ISO 3166-1 country code.

allBankAccAdded

boolean

Boolean flag, use 'true' if all bank accounts are added to the Legal entity, otherwise use 'false'.

regionId

uuid

required

length ≤ 36

A TIS internal (uuid) ID of the region in TIS to which a Legal entity is to be associated. Use the GET regions API to extract the regionId.

creditorId

array of strings

A list of creditor IDs. Optional field. Supports alphanumeric value, up to 36 characters, for each of the IDs.

creditorId

customFields

array of objects

customFields

Responses

5XX

Error response code which is returned when an internal server error occurs

200Update Legal entity

4XXError caused by the client, like invalid inputs or missing authorization.