Create new Legal entity

post

https://api-mtls.eu.tispayments.com/rest/api/v2/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

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.

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

creditorId

customFields

array of objects

customFields

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

5XX

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

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

201The id of the created Legal entity

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