API Reference

Create new Legal entity

post
https://api-mtls.eu.tispayments.com/rest/api/bam/legal-entities

Use this endpoint to create a new Legal entity in TIS. Include all required and valid details of the Legal entity in the request body to ensure successful creation.

Body Params
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.

string
required
length ≤ 255

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

string
length ≤ 255

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

string
length ≤ 64

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

string
length ≤ 64

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

string
length ≤ 2

ISO 3166-1 alpha-2 code

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.

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.

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 value up to 36 characters, for each of the IDs.

creditorId
customFields
array of objects
customFields
Responses

5XX

An error response code is returned when an internal server error occurs

Updated 5 months ago

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago