Data Schema

Ammitto uses JSON-LD format for all data, providing semantic web compatibility and easy integration with modern applications.

Entity Types

PersonEntity

An individual person subject to sanctions.

Fields: names, birthInfo, addresses, gender, title, position, remarks

OrganizationEntity

A company, organization, or other legal entity subject to sanctions.

Fields: names, addresses, remarks

VesselEntity

A ship or maritime vessel subject to sanctions.

Fields: names, imoNumber, remarks

AircraftEntity

An aircraft subject to sanctions.

Fields: names, remarks

Full Schema

Entity Schema

{
  "@context": "https://ammitto.org/api/v1/context.jsonld",
  "@graph": [
    {
      "@id": "string",
      "@type": "PersonEntity | OrganizationEntity | VesselEntity | AircraftEntity",
      "entityType": "person | organization | vessel | aircraft",
      "names": [
        {
          "@type": "NameVariant",
          "fullName": "string",
          "script": "string (ISO 15924, e.g. Latn, Arab, Cyrl)",
          "isPrimary": "boolean"
        }
      ],
      "sourceReferences": [
        {
          "@type": "SourceReference",
          "sourceCode": "string",
          "referenceNumber": "string (optional)",
          "url": "string (optional)",
          "retrievedAt": "string (ISO 8601)"
        }
      ],
      "birthInfo": [
        {
          "@type": "BirthInfo",
          "date": "string (optional)",
          "year": "integer (optional, when only the year is known)",
          "circa": "boolean",
          "country": "string (optional)"
        }
      ],
      "addresses": [
        {
          "@type": "Address",
          "street": "string (optional)",
          "city": "string (optional)",
          "state": "string (optional)",
          "country": "string (optional)",
          "postalCode": "string (optional)"
        }
      ],
      "identifications": [
        {
          "@type": "Identification",
          "type": "string (passport, national-id, ...)",
          "number": "string",
          "issuingCountry": "string (optional)"
        }
      ],
      "nationalities": ["string"],
      "hasSanctionEntry": ["string (IRI of a SanctionEntry node)"],
      "remarks": "string (optional)"
    }
  ]
}

Field Descriptions

Field	Type	Description
@id	string	Unique identifier for the entity
@type	string	Entity type (PersonEntity, OrganizationEntity, etc.)
entityType	string	Normalized entity type (person, organization, vessel, aircraft)
names	array	Array of name objects with fullName and isPrimary flag
sourceReferences	array	Array of source reference objects
birthInfo	array	Birth date and country information (persons only)
addresses	array	Array of address objects (persons and organizations only)
nationalities	array	Nationality names, as plain strings rather than objects
identifications	array	Passport, national ID and other document numbers
hasSanctionEntry	array	IRIs of the SanctionEntry nodes designating this entity
remarks	string	Additional remarks or notes