Update the current entity

1 import requests 2 3 url = "https://api.sandbox.monite.com/v1/entities/me" 4 5 payload = {} 6 headers = { 7 "x-monite-version": "2024-05-25", 8 "Authorization": "Bearer <token>", 9 "Content-Type": "application/json" 10 } 11 12 response = requests.patch(url, json=payload, headers=headers) 13 14 print(response.json())

1 { 2 "type": "individual", 3 "address": { 4 "city": "city", 5 "country": "AF", 6 "line1": "line1", 7 "postal_code": "postal_code", 8 "line2": "line2", 9 "state": "state" 10 }, 11 "created_at": "2024-01-15T09:30:00Z", 12 "id": "id", 13 "individual": { 14 "first_name": "first_name", 15 "last_name": "last_name", 16 "date_of_birth": "date_of_birth", 17 "id_number": "id_number", 18 "ssn_last_4": "ssn_last_4", 19 "title": "title" 20 }, 21 "status": "active", 22 "updated_at": "2024-01-15T09:30:00Z", 23 "email": "email", 24 "logo": { 25 "id": "id", 26 "created_at": "2024-01-15T09:30:00Z", 27 "file_type": "payables", 28 "md5": "31d1a2dd1ad3dfc39be849d70a68dac0", 29 "mimetype": "application/pdf", 30 "name": "invoice.pdf", 31 "region": "eu-central-1", 32 "size": 24381, 33 "url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf", 34 "pages": [ 35 { 36 "id": "id", 37 "mimetype": "image/png", 38 "number": 0, 39 "size": 21972, 40 "url": "https://bucket.s3.amazonaws.com/123/456.png" 41 } 42 ], 43 "previews": [ 44 { 45 "height": 400, 46 "url": "https://bucketname.s3.amazonaws.com/1/2/3.png", 47 "width": 200 48 } 49 ] 50 }, 51 "phone": "phone", 52 "registration_authority": "registration_authority", 53 "registration_number": "registration_number", 54 "tax_id": "tax_id", 55 "website": "website" 56 }

Deprecated. Use PATCH /entity_users/my_entity instead.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

addressobjectOptional

An address description of the entity

emailstringOptionalformat: "email"

An official email address of the entity

individualobjectOptional

A set of meta data describing the individual

organizationobjectOptional

A set of meta data describing the organization

phonestringOptional<=100 characters

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

registration_authoritystringOptional>=1 character<=100 characters

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

registration_numberstringOptional>=1 character<=100 characters

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

tax_idstringOptional>=1 character<=30 characters

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.

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](https://docs.monite.com/payments/index) 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`](https://docs.monite.com/api/entity-onboarding-data/patch-entities-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.

websitestringOptionalformat: "uri">=1 character<=2083 characters

A website of the entity

Response

Successful Response

individualobject

organizationobject

Authentication

Headers

Request

Response

Errors