English
EspañolEnglishPortuguêsFilipino
Get free API key
International · intl_multi_sanctions_record_id
OpenAPI

Lookup multi · sanctions by RECORD_ID

GET https://api.latinfo.dev/intl/multi/sanctions/record_id/{record_id}

One published sanctioned subject: entity, vessel or aircraft; individuals are excluded. Coverage: Non-person subjects from OFAC SDN, UN consolidated and EU consolidated sanctions lists. Use a list prefix OFAC, UNSC or EUFS followed by eleven padded digits. A name is not a record identifier. A name-search result is a candidate, not a confirmed sanctions match; verify identifier, aliases, list and reference. Returns one record. Import time is not observation time; inspect freshness headers.

Source contract

Publisher
US Treasury OFAC / United Nations / European Commission
Coverage
Non-person subjects from OFAC SDN, UN consolidated and EU consolidated sanctions lists.
Record meaning
One published sanctioned subject: entity, vessel or aircraft; individuals are excluded.
Identifier
Use a list prefix OFAC, UNSC or EUFS followed by eleven padded digits. A name is not a record identifier.
Accepted pattern
^(OFAC|UNSC|EUFS)[0-9]{11}$
Cardinality
one
License
Reuse permission has not been verified. Public access is not a reuse license.

Known limitations

  • A name-search result is a candidate, not a confirmed sanctions match; verify identifier, aliases, list and reference.

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

record_idstringpathrequired

RECORD_ID in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: OFAC00000000036

Request example

curl https://api.latinfo.dev/intl/multi/sanctions/record_id/OFAC00000000036 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Responses

200Published source records. Missing data is not a clearance or a negative finding.

Response headers

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

Content-Type: application/json

Response fields

record_id string required

Use a list prefix OFAC, UNSC or EUFS followed by eleven padded digits. A name is not a record identifier.

source string required

Upstream sanctions list identifier.

type string required

Sanctioned subject type: entity, vessel or aircraft; individuals are excluded at import.

name string required

Published entity name.

aliases string required

Semicolon-separated published aliases; searchable.

programs string required

Pipe-separated sanctions-program codes.

listed_on string required

Published listed on date. Format: YYYY-MM-DD.

reference string required

Publisher-specific sanctions reference, when available.

dob string required

Reserved personal-date field; not used for non-person subjects. Empty for non-person subjects; personal subjects are excluded during import.

pob string required

Reserved birthplace field; not used for non-person subjects. Empty for non-person subjects; personal subjects are excluded during import.

nationality string required

Reserved nationality field; not used for non-person subjects. Empty for non-person subjects; personal subjects are excluded during import.

Response schema
{
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "description": "Use a list prefix OFAC, UNSC or EUFS followed by eleven padded digits. A name is not a record identifier."
    },
    "source": {
      "type": "string",
      "description": "Upstream sanctions list identifier.",
      "x-latinfo-meaning": "text"
    },
    "type": {
      "type": "string",
      "description": "Sanctioned subject type: entity, vessel or aircraft; individuals are excluded at import.",
      "x-latinfo-meaning": "text"
    },
    "name": {
      "type": "string",
      "description": "Published entity name.",
      "x-latinfo-meaning": "text"
    },
    "aliases": {
      "type": "string",
      "description": "Semicolon-separated published aliases; searchable.",
      "x-latinfo-meaning": "text"
    },
    "programs": {
      "type": "string",
      "description": "Pipe-separated sanctions-program codes.",
      "x-latinfo-meaning": "text"
    },
    "listed_on": {
      "type": "string",
      "description": "Published listed on date. Format: YYYY-MM-DD.",
      "x-latinfo-meaning": "date"
    },
    "reference": {
      "type": "string",
      "description": "Publisher-specific sanctions reference, when available.",
      "x-latinfo-meaning": "text"
    },
    "dob": {
      "type": "string",
      "description": "Reserved personal-date field; not used for non-person subjects. Empty for non-person subjects; personal subjects are excluded during import.",
      "x-latinfo-meaning": "reserved"
    },
    "pob": {
      "type": "string",
      "description": "Reserved birthplace field; not used for non-person subjects. Empty for non-person subjects; personal subjects are excluded during import.",
      "x-latinfo-meaning": "reserved"
    },
    "nationality": {
      "type": "string",
      "description": "Reserved nationality field; not used for non-person subjects. Empty for non-person subjects; personal subjects are excluded during import.",
      "x-latinfo-meaning": "reserved"
    }
  },
  "required": [
    "record_id",
    "source",
    "type",
    "name",
    "aliases",
    "programs",
    "listed_on",
    "reference",
    "dob",
    "pob",
    "nationality"
  ],
  "additionalProperties": false
}
400Invalid identifier or query. Correct the input before retrying.
No response body documented.
401Missing or invalid API key. Authenticate before retrying.
No response body documented.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No response body documented.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No response body documented.
503Source unavailable. Report unavailable, not an empty result.
No response body documented.
Example JSON

Illustrative schema example. This is not a live response.

{
  "record_id": "string",
  "source": "string",
  "type": "string",
  "name": "string",
  "aliases": "string",
  "programs": "string",
  "listed_on": "string",
  "reference": "string",
  "dob": "string",
  "pob": "string",
  "nationality": "string"
}

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.

Esc