Get a legal entity · Ownrecord docs

Returns one legal entity by its ID (ent_…): legal data, establishment, home tax ID and its verification, default currency, time zone and invoice settings. Entities outside the organization, or outside the entity of an entity-scoped request, are resource_not_found.

At a glance

REST: GET /api/v1/entities/{id}
MCP tool: entities_get
Operation ID: entities.get
Scope: Organization, or one of its legal entities or brands
Permission: entities:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Authentication: API key with the entities:read scope
Since: M1

Request

Path parameters

Field	Type	Description
`id`	`ent_…` ID

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

Field	Type	Description
`id`	`ent_…` ID
`object`	`"legal_entity"`
`orgId`	`org_…` ID
`slug`	string
`legalName`	string
`tradingName`	string or null
`establishment`	object
`establishment.country`	string
`establishment.subdivision`	string or null
`establishment.address`	object
`establishment.address.line1`	string
`establishment.address.line2`	string or null
`establishment.address.city`	string
`establishment.address.postalCode`	string or null
`establishment.address.region`	string or null
`establishment.address.country`	string
`establishment.companyRegistryId`	string
`establishment.euVatEstablished`	boolean
`homeTaxId`	object
`homeTaxId.type`	string
`homeTaxId.value`	string
`verification`	object
`verification.status`	one of `unverified`, `pending_review`, `verified`, `rejected`
`verification.method`	one of `vies`, `hmrc`, `ch_uid`, `document`
`verification.checkedAt`	date-time or null
`defaultCurrency`	string
`timezone`	string
`invoiceSettings`	object
`invoiceSettings.numberFormat`	string
`invoiceSettings.sequenceResetYearly`	boolean
`invoiceSettings.language`	string
`invoiceSettings.bilingual`	string or null
`invoiceSettings.footerText`	string or null
`invoiceSettings.bankTransfer`	object or null
`status`	one of `onboarding`, `active`, `suspended`, `archived`
`createdAt`	date-time
`updatedAt`	date-time

Examples

Read an entity

HTTP

GET /api/v1/entities/ent_01m4tx5nj8emwbyf7y9vcf47x2
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "id": "ent_01m4tx5nj8emwbyf7y9vcf47x2",
  "object": "legal_entity",
  "orgId": "org_01m4tx5nj7ekd958x53w4bntcg",
  "slug": "acme-hr",
  "legalName": "Acme Digital d.o.o.",
  "tradingName": null,
  "establishment": {
    "country": "HR",
    "subdivision": null,
    "address": {
      "line1": "Ilica 1",
      "line2": null,
      "city": "Zagreb",
      "postalCode": "10000",
      "region": null,
      "country": "HR"
    },
    "companyRegistryId": "080000000",
    "euVatEstablished": true
  },
  "homeTaxId": {
    "type": "eu_vat",
    "value": "HR12345678901"
  },
  "verification": {
    "status": "unverified",
    "method": "vies",
    "checkedAt": null
  },
  "defaultCurrency": "EUR",
  "timezone": "Europe/Zagreb",
  "invoiceSettings": {
    "numberFormat": "{series}-{year}-{seq:06}",
    "sequenceResetYearly": true,
    "language": "en",
    "bilingual": null,
    "footerText": null,
    "bankTransfer": null
  },
  "status": "onboarding",
  "createdAt": "2026-10-13T12:00:00.000Z",
  "updatedAt": "2026-10-13T12:00:00.000Z"
}

Errors

Code	HTTP status	When	What to do
`resource_not_found`	404	No entity with this ID is visible to the request.	Check the ID and that your credentials are scoped to the right organization, entity, brand and mode.
`permission_denied`	403	You can't see legal entities here.	Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Path parameters#

Query parameters#

Response#

Examples#

Read an entity#

Errors#