OPopensanctions
Data access

Fetch Entity

Changed on

Retrieve a single entity by its ID. The entity will be returned in full, with data from all datasets and with nested entities (adjacent passport, sanction and associated entities) included. If the entity ID has been merged into a different canonical entity, an HTTP redirect will be triggered.

Intro: entity data model.

get/entities/{entity_id}

Request

  • Base URL
    https://api.opensanctions.org (the document declares no server; this is the origin it was published from)
  • URL
    https://api.opensanctions.org/entities/{entity_id}
  • Auth
    none declared

Path parameters

entity_idstring required

ID of the entity to retrieve

Example:Q7747

Query parameters

nestedboolean

Response

Successful Response

idstring required
captionstring required
schemastring required
propertiesobject required
datasetsstring[]
referentsstring[]
targetboolean
first_seenstring
last_seenstring
last_changestring

Example response

{
  "id": "NK-A7z....",
  "caption": "John Doe",
  "schema": "LegalEntity",
  "properties": {
    "name": [
      "John Doe"
    ]
  },
  "datasets": [
    "us_ofac_sdn"
  ],
  "referents": [
    "ofac-1234"
  ],
  "first_seen": "2026-01-01T12:00:00Z",
  "last_seen": "2026-01-01T12:00:00Z",
  "last_change": "2026-01-01T12:00:00Z"
}

Changes

  • c5a282ece45dRevision changes
    • info

      removed subschema #1 subschema #2 from the response property anyOf list for the response status

    • info

      removed subschema #1 subschema #2 from the response property anyOf list for the response status

    • info

      removed subschema #1 subschema #2 from the response property anyOf list for the response status

  • 024572c7ad35Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status