Get a legal entity's verification

Returns one legal entity as the verification queue shows it (spec §39.1): its registry facts (legal name, address, company registry ID, home tax ID), its verification (status, method, when, by whom, notes), its organization and the documents its organization uploaded for it (file IDs, names, types and sizes). Platform admins only.

At a glance

REST: GET /api/v1/platform/verifications/{orgId}/{entityId}
MCP tool: platform_verifications_get
Operation ID: platform.verifications.get
Scope: Platform
Permission: platform:write
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Authentication: API key with the platform:write scope
Since: M12

Request

Path parameters

Field	Type	Description
`orgId`	`org_…` ID	The entity's organization.
`entityId`	`ent_…` ID	The legal entity.

Query parameters

This operation takes no query parameters.

Response

200 OK with a JSON object:

Field	Type	Description
`object`	`"platform_entity_verification"`
`org`	object
`org.id`	`org_…` ID
`org.slug`	string
`org.name`	string
`entity`	object
`entity.id`	`ent_…` ID
`entity.slug`	string
`entity.legalName`	string
`entity.tradingName`	string or null
`entity.country`	string
`entity.status`	string
`entity.verification`	object
`entity.verification.status`	one of `unverified`, `pending_review`, `verified`, `rejected`
`entity.verification.method`	one of `vies`, `hmrc`, `ch_uid`, `document`
`entity.verification.checkedAt`	date-time or null
`entity.verification.reviewer`	`usr_…` ID or null
`entity.verification.notes`	string or null
`entity.verification.documentFileId`	`file_…` ID or null	The registry extract under review (`entities.registry_extract.upload`).
`entity.address`	object
`entity.address.line1`	string
`entity.address.line2`	string or null
`entity.address.city`	string
`entity.address.postalCode`	string or null
`entity.address.region`	string or null
`entity.address.country`	string
`entity.companyRegistryId`	string
`entity.homeTaxId`	object
`entity.homeTaxId.type`	string
`entity.homeTaxId.value`	string
`waitingSince`	date-time
`documents`	array of object
`documents[].id`	`file_…` ID
`documents[].filename`	string or null
`documents[].kind`	string
`documents[].contentType`	string
`documents[].size`	integer
`documents[].livemode`	boolean
`documents[].underReview`	boolean	The extract the entity's verification names (the latest upload).
`documents[].createdAt`	date-time

Examples

An entity waiting for review

HTTP

GET /api/v1/platform/verifications/org_01m5wvkry1e6w94sjxgme33fs6/ent_01m5wvkry1e6w94sjxgme33fsg
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "platform_entity_verification",
  "org": {
    "id": "org_01m5wvkry1e6w94sjxgme33fs6",
    "slug": "nordwind",
    "name": "Nordwind"
  },
  "entity": {
    "id": "ent_01m5wvkry1e6w94sjxgme33fsg",
    "slug": "nordwind-no",
    "legalName": "Nordwind Software AS",
    "tradingName": null,
    "country": "NO",
    "status": "onboarding",
    "verification": {
      "status": "pending_review",
      "method": "document",
      "checkedAt": null,
      "reviewer": null,
      "notes": null,
      "documentFileId": "file_01m5wvkry1e6w94sjxgme33fsn"
    },
    "address": {
      "line1": "Karl Johans gate 1",
      "line2": null,
      "city": "Oslo",
      "postalCode": "0154",
      "region": null,
      "country": "NO"
    },
    "companyRegistryId": "923 456 789",
    "homeTaxId": {
      "type": "no_vat",
      "value": "NO923456789MVA"
    }
  },
  "waitingSince": "2026-11-02T13:10:00.000Z",
  "documents": [
    {
      "id": "file_01m5wvkry1e6w94sjxgme33fsn",
      "filename": "brreg-extract.pdf",
      "kind": "registry_extract",
      "contentType": "application/pdf",
      "size": 184220,
      "livemode": true,
      "underReview": true,
      "createdAt": "2026-11-02T13:09:41.000Z"
    }
  ]
}

Errors

Code	HTTP status	When	What to do
`resource_not_found`	404	The organization has no legal entity with this ID.	Check the ID and that your credentials are scoped to the right organization, entity, brand and mode.
`permission_denied`	403	You aren't a platform admin.	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#

An entity waiting for review#

Errors#