Jump to

• Request
• Response

Retrieve reservation manifest to generate EES request file

get

/spms/v2/ships/{shipId}/borderControls/ees/guestManifestLists

This is to retrieve the listing of reservation manifest based on the selected criteria to confirm the data before creating the EES request file.

Request

Supported Media Types

• application/json

Path Parameters

• shipId(required): number
  Ship Id

Query Parameters

• embarkationHarborId(required): number
  Embarkation Harbor ID
• itineraryId(required): integer
  Cruise itinerary ID
• orderBy: string
  Order by Folio Number, Surname, Given Name and Nationality with format column1:asc/desc,column2:asc/desc

  Default Value: pReqID:asc
• profileType: string
  Reservation Profile Type

  Allowed Values: [ "Guest", "Crew" ]

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : eesGuestManifestResponse

Type: object

Title: eesGuestManifestResponse

EES Guest Manifest Lists Response

Show Source

• arrivalDate: string(ISO 8601 (YYYY-MM-DD))
  Embarkation Date

  Example: 2025-04-19
• arrivalHarbor: object arrivalHarbor
  Arrival Harbor Object
• cruiseItineraryName: string
  Minimum Length: 1

  Maximum Length: 50

  Pattern: ^[a-zA-Z0-9 _,\?/\.\-\\+\* ~!@#$%&{}\[\]()=<>\|\^\'\":;@`]*$

  Cruise Itinerary Name

  Example: Fjord Itinerary
• departureDateTime: string(YYYY-MM-DD HH:mm)
  Disembarkation Date & Time

  Example: 2025-04-20 16:15
• disembarkationHarbor: string
  Disembarkation Harbor Name

  Example: White Harbour
• guestManifestList: array guestManifestGuestListObject
• profileType: string
  Allowed Values: [ "Guest", "Crew" ]

  Reservation Profile Type

  Example: Guest
• scheduleNo: string
  Minimum Length: 1

  Maximum Length: 18

  Schedule Number

  Example: SN1001

{
    "title":"eesGuestManifestResponse",
    "description":"EES Guest Manifest Lists Response",
    "type":"object",
    "properties":{
        "scheduleNo":{
            "$ref":"#/definitions/scheduleNo"
        },
        "cruiseItineraryName":{
            "$ref":"#/definitions/cruiseItineraryName"
        },
        "arrivalDate":{
            "$ref":"#/definitions/eesArrivalDate"
        },
        "arrivalHarbor":{
            "$ref":"#/definitions/arrivalHarbor"
        },
        "departureDateTime":{
            "$ref":"#/definitions/departureDateTime"
        },
        "disembarkationHarbor":{
            "$ref":"#/definitions/disembarkationHarbor"
        },
        "profileType":{
            "$ref":"#/definitions/profileType"
        },
        "guestManifestList":{
            "$ref":"#/definitions/guestManifestGuestListObject"
        }
    }
}

Nested Schema : arrivalHarbor

Type: object

Arrival Harbor Object

Show Source

• code: number
  Pattern: ^[0-9]*$

  Example: 11
• countryCode: string
  Minimum Length: 1

  Maximum Length: 40

  Country Code

  Example: ESP
• countryDescription: string
  Country Name

  Example: United States
• description: string
  Embarkation Harbor Name

  Example: White Harbour

{
    "description":"Arrival Harbor Object",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/embarkationHarborId"
        },
        "description":{
            "$ref":"#/definitions/embarkationHarborName"
        },
        "countryCode":{
            "$ref":"#/definitions/countryCode"
        },
        "countryDescription":{
            "$ref":"#/definitions/countryDescription"
        }
    }
}

Nested Schema : guestManifestGuestListObject

Type: array

Show Source

• Array of: object guestManifestGuestList
  Guest Manifest List

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/guestManifestGuestList"
    }
}

Nested Schema : guestManifestGuestList

Type: object

Guest Manifest List

Show Source

• arrivalDate: string(ISO 8601 (YYYY-MM-DD))
  Guest Arrival Date

  Example: 2025-04-19
• arrivalDestination: object arrivalDestination
  Guest Arrival Destination
• dateOfBirth: string(ISO 8601 (YYYY-MM-DD))
  Date of Birth

  Example: 1999-02-15
• departureDateTime: string(YYYY-MM-DD HH:mm)
  Guest Departure Date & Time

  Example: 2025-04-20 16:15
• doubleEntryRequired: string
  Double entry required * YES * NO

  Example: YES
• eesEtiasOutOfScope: string
  Traveller out of EES/ETIAS scope * YES * NO

  Example: NO
• expiryDate: string(ISO 8601 (YYYY-MM-DD))
  Travel Document Expiry Date

  Example: 2025-02-25
• givenName: string
  Minimum Length: 1

  Maximum Length: 39

  First Name

  Example: Maya
• inTransit: string
  Traveller in transit * YES * NO

  Example: NO
• issuingState: object issuingState
  Travel Document Issued Country
• paxNationality: object paxNationality
  Nationality
• pReqID: number
  Minimum Length: 1

  Pattern: ^[0-9]*$

  Folio Number (Reservation Account Id)

  Example: 1001
• sex: string
  Gender * Female * Male * Unspecified

  Example: Female
• stateroomNo: string
  Minimum Length: 1

  Maximum Length: 20

  Stateroom Number

  Example: 1020
• surname: string
  Minimum Length: 1

  Maximum Length: 39

  Last Name

  Example: Walters
• travelDocNbr: string
  Pattern: ^[A-Z0-9]{16}$

  Travel Document Number

  Example: A1510202
• travelDocType: string
  Minimum Length: 1

  Maximum Length: 8

  Travel Document Type

  Example: passport

{
    "description":"Guest Manifest List",
    "type":"object",
    "properties":{
        "pReqID":{
            "$ref":"#/definitions/pReqID"
        },
        "surname":{
            "$ref":"#/definitions/surnameResponse"
        },
        "givenName":{
            "$ref":"#/definitions/givenNameResponse"
        },
        "stateroomNo":{
            "$ref":"#/definitions/stateroomNo"
        },
        "dateOfBirth":{
            "$ref":"#/definitions/dateOfBirth"
        },
        "sex":{
            "$ref":"#/definitions/sex"
        },
        "paxNationality":{
            "$ref":"#/definitions/paxNationality"
        },
        "travelDocType":{
            "$ref":"#/definitions/travelDocType"
        },
        "travelDocNbr":{
            "$ref":"#/definitions/travelDocNbr"
        },
        "expiryDate":{
            "$ref":"#/definitions/expiryDate"
        },
        "issuingState":{
            "$ref":"#/definitions/issuingState"
        },
        "inTransit":{
            "$ref":"#/definitions/inTransit"
        },
        "doubleEntryRequired":{
            "$ref":"#/definitions/doubleEntryRequired"
        },
        "eesEtiasOutOfScope":{
            "$ref":"#/definitions/eesEtiasOutOfScope"
        },
        "arrivalDestination":{
            "$ref":"#/definitions/arrivalDestination"
        },
        "arrivalDate":{
            "$ref":"#/definitions/guestArrivalDate"
        },
        "departureDateTime":{
            "$ref":"#/definitions/guestDepartureDateTime"
        }
    }
}

Nested Schema : arrivalDestination

Type: object

Guest Arrival Destination

Show Source

• countryCode: string
  Minimum Length: 1

  Maximum Length: 40

  Country Code

  Example: ESP
• countryDescription: string
  Country Name

  Example: United States
• harborCode: string
  Minimum Length: 1

  Maximum Length: 6

  Pattern: ^[a-zA-Z0-9- ]*$

  Disembarkation Harbor Code

  Example: White
• harborDescription: string
  Minimum Length: 1

  Maximum Length: 1000

  Pattern: ^[a-zA-ZÀ-ÖØ-öø-࿰-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$

  Disembarkation Harbor Name

  Example: White Harbour

{
    "description":"Guest Arrival Destination",
    "type":"object",
    "properties":{
        "harborCode":{
            "$ref":"#/definitions/disembarkationHarborCode"
        },
        "harborDescription":{
            "$ref":"#/definitions/disembarkationHarborName"
        },
        "countryCode":{
            "$ref":"#/definitions/countryCode"
        },
        "countryDescription":{
            "$ref":"#/definitions/countryDescription"
        }
    }
}

Nested Schema : issuingState

Type: object

Travel Document Issued Country

Show Source

• code: string
  Minimum Length: 1

  Maximum Length: 40

  Country Code

  Example: ESP
• description: string
  Country Name

  Example: United States

{
    "description":"Travel Document Issued Country",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/countryCode"
        },
        "description":{
            "$ref":"#/definitions/countryDescription"
        }
    }
}

Nested Schema : paxNationality

Type: object

Nationality

Show Source

• code: string
  Minimum Length: 1

  Maximum Length: 40

  Country Code

  Example: ESP
• description: string
  Country Name

  Example: United States

{
    "description":"Nationality",
    "type":"object",
    "properties":{
        "code":{
            "$ref":"#/definitions/countryCode"
        },
        "description":{
            "$ref":"#/definitions/countryDescription"
        }
    }
}

204 Response

No Content

400 Response

Bad Request

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
        "title":"Bad Request",
        "detail":"The parameter 'shipId' has incorrect format"
    }
}

Example:

{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Bad Request",
    "detail":"The parameter 'shipId' has incorrect format"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
        "title":"Unauthorized",
        "detail":"Valid token is required to access this resource"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
    "title":"Unauthorized",
    "detail":"Valid token is required to access this resource"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

403 Response

Forbidden

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
        "title":"Forbidden",
        "detail":"Access to this resource is forbidden"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
    "title":"Forbidden",
    "detail":"Access to this resource is forbidden"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

404 Response

Not Found

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
        "title":"Not Found",
        "detail":"HTTP 404 Not Found"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
    "title":"Not Found",
    "detail":"HTTP 404 Not Found"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

405 Response

Method Not Allowed

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
        "title":"Method Not Supported",
        "detail":"HTTP method not supported for this resource"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
    "title":"Method Not Supported",
    "detail":"HTTP method not supported for this resource"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

406 Response

Not Acceptable

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
        "title":"Not Acceptable",
        "detail":"Request a Mime type that is supported for this Resource"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
    "title":"Not Acceptable",
    "detail":"Request a Mime type that is supported for this Resource"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

410 Response

Gone

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.11",
        "title":"Gone",
        "detail":"Requested Resource no longer exists"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.11",
    "title":"Gone",
    "detail":"Requested Resource no longer exists"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

415 Response

Unsupported Media Type

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
        "title":"Invalid content",
        "detail":"Content type not supported"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
    "title":"Invalid content",
    "detail":"Content type not supported"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

500 Response

Internal Server Error

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
        "title":"Internal Server Error",
        "detail":"Issue fulfilling request. Please retry or contact support"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
    "title":"Internal Server Error",
    "detail":"Issue fulfilling request. Please retry or contact support"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

501 Response

Not Implemented

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
        "title":"Not implemented",
        "detail":"Resource is not implemented in this version of the API"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
    "title":"Not implemented",
    "detail":"Resource is not implemented in this version of the API"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

503 Response

Service Unavailable

Body ()

Root Schema : schema

Match All

Show Source

• object Error Response
  Title: Error Response

  Error Response returned when encountered error

{
    "allOf":[
        {
            "$ref":"#/definitions/eesRequestFileErrorResponse"
        }
    ],
    "example":{
        "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
        "title":"Service Unavailable",
        "detail":"Service not available"
    }
}

Example:

{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
    "title":"Service Unavailable",
    "detail":"Service not available"
}

Nested Schema : Error Response

Type: object

Title: Error Response

Error Response returned when encountered error

Show Source

• detail: string
• title: string
• type: string

{
    "title":"Error Response",
    "description":"Error Response returned when encountered error",
    "type":"object",
    "properties":{
        "type":{
            "type":"string"
        },
        "title":{
            "type":"string"
        },
        "detail":{
            "type":"string"
        }
    }
}

Back to Top