Update legal entity
curl --request PATCH \
--url https://api.entendre.finance/v1/legal-entities/{legal_entity_id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{}'const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.entendre.finance/v1/legal-entities/{legal_entity_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.entendre.finance/v1/legal-entities/{legal_entity_id}"
payload = {}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "le_456def",
"name": "Example Company",
"entity_type": "C-CORP",
"status": "active",
"base_currency": "USD",
"address": {
"line1": "100 Example Street",
"line2": null,
"city": "New York",
"state": null,
"country": "US",
"zipcode": "10001"
},
"address_string": null,
"created_at": "2026-08-31T12:00:00Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid path, query or request body.",
"request_id": "req_example"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired API Key",
"request_id": "req_example",
"suggested_action": "Send an API key in X-API-Key, or an OAuth access token as Authorization: Bearer. Refresh an expired access token.",
"documentation_url": "https://entendre.ai/docs/get-started/authentication"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Insufficient access to organization",
"request_id": "req_example"
}
}{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"request_id": "req_example"
}
}{
"error": {
"code": "CONFLICT",
"message": "The resource state does not allow this operation.",
"request_id": "req_example"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Retry after 30s.",
"request_id": "req_example"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error",
"request_id": "req_example"
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service unavailable.",
"request_id": "req_example"
}
}Legal Entities
Update legal entity
Updates legal entity details or archives the entity. Changes that conflict with its accounting history are rejected.
PATCH
/
v1
/
legal-entities
/
{legal_entity_id}
Update legal entity
curl --request PATCH \
--url https://api.entendre.finance/v1/legal-entities/{legal_entity_id} \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{}'const options = {
method: 'PATCH',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.entendre.finance/v1/legal-entities/{legal_entity_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.entendre.finance/v1/legal-entities/{legal_entity_id}"
payload = {}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"id": "le_456def",
"name": "Example Company",
"entity_type": "C-CORP",
"status": "active",
"base_currency": "USD",
"address": {
"line1": "100 Example Street",
"line2": null,
"city": "New York",
"state": null,
"country": "US",
"zipcode": "10001"
},
"address_string": null,
"created_at": "2026-08-31T12:00:00Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid path, query or request body.",
"request_id": "req_example"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired API Key",
"request_id": "req_example",
"suggested_action": "Send an API key in X-API-Key, or an OAuth access token as Authorization: Bearer. Refresh an expired access token.",
"documentation_url": "https://entendre.ai/docs/get-started/authentication"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Insufficient access to organization",
"request_id": "req_example"
}
}{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"request_id": "req_example"
}
}{
"error": {
"code": "CONFLICT",
"message": "The resource state does not allow this operation.",
"request_id": "req_example"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Retry after 30s.",
"request_id": "req_example"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error",
"request_id": "req_example"
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service unavailable.",
"request_id": "req_example"
}
}Authorizations
Your organization API key. See Authentication.
Headers
Optional retry key. Check X-Idempotency-Applied before relying on replay protection.
Required string length:
1 - 255Path Parameters
ID of the legal entity.
Minimum string length:
1Body
application/json
Updated display name.
Updated status.
Available options:
active, archived Legal entity type.
Available options:
C-CORP, S-CORP, LLC, LP, LLP, GmbH, Ltd, PLC, Foundation, Trust, Non-Profit, Sole Proprietorship, DAO, Other Base reporting currency (ISO 4217). Applies to new data only; past journals do not change.
Examples:
"USD"
"EUR"
Replace the structured address. Set null to clear.
Show child attributes
Show child attributes
Address as one line of text, up to 500 characters. Send null to clear it. address takes precedence when both are set.
Maximum string length:
500Response
The request succeeded.
Show child attributes
Show child attributes