Entities

Update an entity

Update entity information for the specified entity ID.

This endpoint requires a partner access token and can be used to update any of the partner's entities.

To update an entity by using an entity user token, use PATCH /entity_users/my_entity instead.

Related endpoints:

patch/entities/{entity_id}

Request

  • Base URL: https://api.sandbox.monite.com/v1
  • URL: https://api.sandbox.monite.com/v1/entities/{entity_id}
  • Auth: HTTP bearer

Path parameters

entity_idstring required

A unique ID to specify the entity.

Headers

x-monite-versionstring required

Request body

emailstring email

An official email address of the entity

phonestring

The contact phone number of the entity. Required for US organizations to use payments.

registration_authoritystring

(Germany only) The name of the local district court (Amtsgericht) where the entity is registered. Required if registration_number is provided.

registration_numberstring

(Germany only) The entity's commercial register number (Handelsregisternummer) in the German Commercial Register, if available.

tax_idstring

The new taxpayer identification number (tax ID) of the entity. Tax ID is required for entities that are not VAT-registered.

Note: If an entity that is onboarded for payments updates its tax ID, this entity must re-accept the Monite payments terms of service (ToS) to continue using payments. To accept the ToS, call PATCH /entities/{entity_id}/onboarding_data and provide the new tos_acceptance.date timestamp. This timestamp must be later than the time when the tax_id was last updated.

websitestring uri

A website of the entity

Response

Successful Response

OR

Changes

No recorded changes to this operation across all 1 revision of this API.