# Get manifest by external ID

Retrieves a single manifest by its unique external identifier. Returns the manifest details without the associated assets/tracks.

Endpoint: GET /integration/rest/api/v1/manifest/{manifestExternalId}
Version: v1
Security: X-AUTH-KEY

## Path parameters:

  - `manifestExternalId` (string, required)
    Unique external id of the manifest. External id is often an id based on the WMS Zimark is integrated with, e.g. an order id.
    Example: "MAN-2024-001"

## Response 200 fields (*/*):

  - `createDate` (string)

  - `updateDate` (string)

  - `externalIdentifier` (string)
    External unique identifier for this manifest.

  - `manifestStatus` (string)
    Current status of the manifest.
    Enum: "PLANNED", "TO_DO", "IN_PROGRESS", "COMPLETED", "CANCELLED"

  - `closeDate` (string)
    Timestamp when the manifest was closed/completed.

  - `activateDate` (string)
    Timestamp when the manifest was activated.

  - `tracksCount` (integer)
    Total number of assets (tracks) currently included in this manifest.

  - `gate` (object)
    Gate details used by the Zimark Integration API.

  - `gate.name` (string)
    Human-readable gate name.

  - `gate.externalIdentifier` (string)
    External unique identifier of the gate.

  - `gate.status` (string)
    Current operational status of the gate.
    Enum: "AVAILABLE", "LOADING", "OUT_OF_SERVICE"

  - `customFields` (array)
    Custom key–value fields attached to the manifest.

  - `customFields.fieldKey` (string)
    Unique key (name) of the custom field. This must match the configured field name.

  - `customFields.fieldValue` (string)
    Value of the custom field as a string. For numeric fields, send the number as a string.

  - `validationErrors` (object)
    Container for validation issues detected when processing a manifest.

  - `validationErrors.duplicatedTracks` (array)
    List of duplicated track issues (same asset added multiple times to the manifest).

  - `validationErrors.duplicatedTracks.trackIdentifier` (string)
    Business identifier of the duplicated track.

  - `validationErrors.duplicatedTracks.addedToManifests` (array)
    List of manifest identifiers where this track is already present.

  - `validationErrors.nonExistingTracks` (array)
    Asset identifiers that could not be found.

  - `validationErrors.deactivatedTracks` (array)
    Asset identifiers that are deactivated and cannot be added.

  - `proofOfShipmentUrl` (string)
    URL to the proof-of-shipment document.

  - `deleted` (boolean)
    Indicates whether the manifest is soft-deleted.

## Response 404 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 500 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id