--- title: "Import a file as a dataset" method: POST path: "/v2/ingest/{fileType}" --- # Import a file as a dataset `POST /v2/ingest/{fileType}` Import a file as an in-memory dataset for use in searches. ## Path parameters - `fileType` string, required ## Response `200` File ingested successfully - IngestFileResponse - `fileType` string — Dataset name used for file import - `entities` Entity[] — Entities that were imported - `addresses` Address[] — Addresses associated with the entity - `line1` string — First line of the address - `line2` string — Second line of the address - `city` string — City name - `postalCode` string — Postal or ZIP code - `state` string — State, province, or region - `country` string — ISO-3166 country code - `latitude` number, double — Latitude of the address - `longitude` number, double — Longitude of the address - `affiliations` Affiliation[] — Other entities this entity is connected to - `entityName` string — Name of the related entity - `type` string — Relationship to the related entity (e.g., "Linked To", "Subsidiary Of", "Owned By") - `details` string — Additional details about the relationship - `aircraft` Aircraft - `altNames` string[] — Alternative names for the aircraft - `built` string, date-time — Build date of the aircraft - `flag` string — Country flag of the aircraft (ISO-3166) - `icaoCode` string — ICAO code of the aircraft - `model` string — Model of the aircraft - `name` string — Name of the aircraft - `serialNumber` string — Serial number of the aircraft - `type` string — Type of aircraft - `business` Business - `altNames` string[] — Alternative names for the business - `created` string, date-time — Creation date of the business - `dissolved` string, date-time — Dissolution date of the business - `governmentIDs` GovernmentID[] — Government-issued identifiers for the business - `name` string — Display name for this identifier - `type` 'passport' | 'drivers-license' | 'national-id' | 'tax-id' | 'ssn' | 'cedula' | 'curp' | 'cuit' | 'electoral' | 'business-registration' | 'commercial-registry' | 'birth-certificate' | 'refugee-id' | 'diplomatic-passport' | 'personal-id' | 'citizenship' | 'nationality' — Kind of government ID - `country` string — Issuing country (ISO-3166) - `identifier` string — The identifier value - `name` string — Name of the business - `contact` Contact - `emailAddresses` string[] — Email addresses associated with the entity - `faxNumbers` string[] — Fax numbers associated with the entity - `phoneNumbers` string[] — Phone numbers associated with the entity - `websites` string[] — Websites associated with the entity - `cryptoAddresses` CryptoAddress[] — Cryptocurrency addresses associated with the entity - `address` string — Cryptocurrency address - `currency` string — Cryptocurrency code (e.g., BTC, ETH, XBT) - `entityType` 'unknown' | 'person' | 'business' | 'organization' | 'aircraft' | 'vessel' — Type of entity - `historicalInfo` HistoricalInfo[] — Historical values for fields that have since changed - `type` string — Kind of historical value (e.g., "Former Name", "Previous Flag") - `value` string — The historical value itself - `date` string, date-time — When this value applied - `name` string — Primary name of the entity - `organization` Organization - `altNames` string[] — Alternative names for the organization - `created` string, date-time — Creation date of the organization - `dissolved` string, date-time — Dissolution date of the organization - `governmentIDs` GovernmentID[] — Government-issued identifiers for the organization - `name` string — Display name for this identifier - `type` 'passport' | 'drivers-license' | 'national-id' | 'tax-id' | 'ssn' | 'cedula' | 'curp' | 'cuit' | 'electoral' | 'business-registration' | 'commercial-registry' | 'birth-certificate' | 'refugee-id' | 'diplomatic-passport' | 'personal-id' | 'citizenship' | 'nationality' — Kind of government ID - `country` string — Issuing country (ISO-3166) - `identifier` string — The identifier value - `name` string — Name of the organization - `person` Person - `altNames` string[] — Alternative names for the person - `birthDate` string, date-time — Birth date of the person - `deathDate` string, date-time — Death date of the person - `gender` string — Gender of the person - `governmentIDs` GovernmentID[] — Government-issued identifiers for the person - `name` string — Display name for this identifier - `type` 'passport' | 'drivers-license' | 'national-id' | 'tax-id' | 'ssn' | 'cedula' | 'curp' | 'cuit' | 'electoral' | 'business-registration' | 'commercial-registry' | 'birth-certificate' | 'refugee-id' | 'diplomatic-passport' | 'personal-id' | 'citizenship' | 'nationality' — Kind of government ID - `country` string — Issuing country (ISO-3166) - `identifier` string — The identifier value - `name` string — Name of the person - `placeOfBirth` string — Place of birth of the person - `titles` string[] — Titles held by the person - `sanctionsInfo` SanctionsInfo - `programs` string[] — Sanction programs the entity falls under (e.g., "SDGT", "IRGC") - `secondary` boolean — Whether the entity is subject to secondary sanctions - `description` string — Additional sanctions details - `sourceList` string — Original list the entity is from - `sourceID` string — Original list identifier - `sourceData` object — Original source data - `vessel` Vessel - `altNames` string[] — Alternative names for the vessel - `built` string, date-time — Build date of the vessel - `callSign` string — Call sign of the vessel - `flag` string — Country flag of the vessel (ISO-3166) - `grossRegisteredTonnage` integer — Gross registered tonnage of the vessel - `imoNumber` string — IMO number of the vessel - `mmsi` string — MMSI of the vessel - `model` string — Model of the vessel - `name` string — Name of the vessel - `owner` string — Owner of the vessel - `tonnage` integer — Tonnage of the vessel - `type` string — Type of vessel ## Other responses - `400` — Missing or invalid fileType - `default` — Unexpected error ## Changes - **2026-05-11** `cd3fd7bac3dd` — 8 breaking, 2 warning, 12 info - the `entities/items/aircraft/built` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200` - the `entities/items/business/created` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200` - the `entities/items/business/dissolved` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200` - the `entities/items/organization/created` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200` - …18 more - **2025-05-19** `9e4cfd7e737c` — 3 info - added the optional property `entities/items/source` to the response with the `200` status - added the optional property `entities/items/sourceData` to the response with the `200` status - added the optional property `entities/items/sourceID` to the response with the `200` status - **2025-05-16** `a56e743ab94d` — 1 info - endpoint added - **2025-03-07** `12d39d9eb42e` — 1 breaking - api path removed without deprecation [Change history](https://skmtc.dev/moov-io/apis/watchman-api/changes/v2/ingest/:fileType/post.md) --- [API](https://skmtc.dev/moov-io/apis/watchman-api.md) · [All operations](https://skmtc.dev/moov-io/apis/watchman-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moov-io/watchman-api/revisions/42ffeeb1e25a/schema)