Retrieve reservation and profile details based on criteria

get

/spms/v1/reservations

This is to retrieve reservation and profile details based on criterias.

Request

Supported Media Types
Query Parameters
  • Minimum Value: 0
    Maximum Value: 1.0E38
    Search for the account id.
  • Minimum Length: 0
    Maximum Length: 20
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the boardcard number.
  • Minimum Length: 0
    Maximum Length: 38
    Pattern: ^[a-zA-Z0-9 ]+?$
    Search for the crew manning number.
  • Search for the reservation debarkation date.
  • Search for the reservation embarkation date.
  • Minimum Length: 0
    Maximum Length: 40
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the input text which match the values in first name.
  • Minimum Length: 0
    Maximum Length: 40
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the input text which match the values in last name
  • Paging limit
  • Minimum Length: 0
    Maximum Length: 40
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the input text which match the values in middle name.
  • Minimum Length: 0
    Maximum Length: 6
    Search for the nationality code.
  • Paging offset.
  • Search for the onboard status, supported values [0,1].
  • Minimum Length: 0
    Maximum Length: 20
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the passport number.
  • Minimum Length: 0
    Maximum Length: 1
    Pattern: ^P|R|C|V|S$
    Search for the profile type, supported values are [P,C,R,V,S] and is supported multiple values. Can be used together with searchValue or reservation status.
  • Minimum Length: 0
    Maximum Length: 100
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the reservation booking number.
  • Minimum Length: 0
    Maximum Length: 2
    Pattern: ^RR|RE|CC|CL|DD|RN|RX
    Search for the reservation status, supported values [CC, RE, CL, DD, RR, RN, RX] and is supported multiple values. Can be used together with searchValue and/ or profile type.
  • Maximum Length: 100
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the input text which match the values either in (First Name, Last Name, Stateroom number,Boardcard number, Set Sail Pass Number, Booking number, Passport number, Manning number). Can be used together with reservation status and/ or profile type.
  • Minimum Length: 0
    Maximum Length: 30
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the Setsailpass number.
  • Minimum Length: 0
    Maximum Length: 20
    Pattern: ^[a-zA-Z0-9 _,?/.\-+*n~!@#$%&{}[]()=<>|^'":;@`]*$
    Search for the stateroom number.
Back to Top

Response

Supported Media Types

200 Response

OK
Body ()
Root Schema : List of reservation search
Type: object
Title: List of reservation search
List of reservation search
Show Source
Nested Schema : ReturnSearchData
Type: object
data return
Show Source
Nested Schema : crewDetails
Type: object
Crew information based on the Profile id passed
Show Source
Nested Schema : guestDetails
Type: object
Guest information based on the Profile id passed
Show Source
Nested Schema : residentDetails
Type: object
Resident information based on the Profile id passed
Show Source
Nested Schema : visitorDetails
Type: object
Visitor information based on the Profile id passed
Show Source
Nested Schema : linksReservations
Type: object
links Reservations
Show Source
Example Response (application/json)
{
    "count":24,
    "hasMore":true,
    "links":[
        {
            "rel":"self",
            "method":"get",
            "href":"http://example.com/spms/v1/reservations?expand=all&serchTerm=john&offset=0&limit=10",
            "operationId":"nextPage"
        }
    ],
    "items":[
        {
            "links":[
                {
                    "rel":"guest",
                    "href":"http://localhost:8080/spms/v1/guest/12345",
                    "method":"get",
                    "operationId":"findByID"
                },
                {
                    "rel":"otherTravelDocument",
                    "href":"http://localhost:8080/spms/v1/guest/12345/otherTravelDocuments",
                    "method":"get",
                    "operationId":"getGuestOtherTravelDocuments"
                }
            ]
        },
        {
            "item":{
                "guestId":12345,
                "title":"Mr",
                "salutation":"MR",
                "firstName":"John",
                "middleName":"Andy",
                "lastName":"Smith",
                "unicodeName":null,
                "dateOfBirth":"1961-04-01",
                "age":57,
                "accountCategory":"PAX",
                "accountType":"System Account Passenger Crew Group Visitor",
                "passportNum":"A01234567",
                "nationalIdNum":123456789,
                "documentIssuedDate":"1961-04-01",
                "documentExpiryDate":"1961-04-01",
                "documentIssuedCountry":"US",
                "countryOfBirth":"US",
                "countryOfResidence":"US",
                "contactNum":"+0123456789",
                "alternativeContactNum":"+0123456789",
                "emailAddress":"EMAIL ADD",
                "emergencyContactName":"John",
                "emergencyContactNum":"+0123456789",
                "gender":"M or F",
                "nationality":"US",
                "reservationAccountReferenceId":12345,
                "reservationStatus":"CC",
                "cabinNum":12345,
                "reservationAccountType":"P",
                "routedAccountNumber":12345,
                "onboardStatus":0,
                "reservationCancelStatus":false,
                "reservationBookingNumber":"0123456789",
                "embarkCruiseId":12345,
                "embarkDate":"2015-09-02",
                "actualEmbarkDate":"2015-09-02",
                "disembarkDate":"2015-09-09",
                "actualDisembarkDate":"null or 2015-09-09",
                "boardCardNumber":123456789,
                "reservationId":12345,
                "accountId":12345,
                "reservationExternalId":12345,
                "embarkPort":123,
                "disembarkPort":123,
                "groupReferenceId":12345,
                "photo":"/Images/People/",
                "classification":"VIP",
                "setSailPass":12345,
                "assemblyStationCode":12345,
                "assemblyStationName":12345,
                "groupName":"Smith",
                "consentStatus":0,
                "travelDocumentNumber":"A12345"
            }
        },
        {
            "links":{
                "rel":"crew",
                "href":"http://localhost:8080/spms/v1/crew/12345",
                "method":"get",
                "operationId":"findByID"
            }
        },
        {
            "item":{
                "guestId":12345,
                "title":"Mr",
                "salutation":"MR",
                "firstName":"John",
                "middleName":"Andy",
                "lastName":"Smith",
                "unicodeName":null,
                "dateOfBirth":"1961-04-01",
                "age":57,
                "accountType":"System Account Passenger Crew Group Visitor",
                "passportNum":"A01234567",
                "nationalIdNum":123456789,
                "documentIssuedDate":"1961-04-01",
                "documentExpiryDate":"1961-04-01",
                "documentIssuedCountry":"US",
                "countryOfBirth":"US",
                "countryOfResidence":"US",
                "contactNum":"+0123456789",
                "alternativeContactNum":"+0123456789",
                "emailAddress":"EMAIL ADD",
                "emergencyContactName":"John",
                "emergencyContactNum":"+0123456789",
                "gender":"M or F",
                "nationality":"US",
                "reservationAccountReferenceId":12345,
                "reservationStatus":"CC",
                "cabinNum":12345,
                "reservationAccountType":"P",
                "onboardStatus":0,
                "reservationCancelStatus":false,
                "reservationBookingNumber":"0123456789",
                "embarkDate":"2015-09-02",
                "actualEmbarkDate":"2015-09-02",
                "disembarkDate":"2015-09-09",
                "actualDisembarkDate":"null or 2015-09-09",
                "boardCardNumber":123456789,
                "reservationId":12345,
                "accountId":12345,
                "embarkPort":123,
                "disembarkPort":123,
                "photo":"/Images/People/",
                "classification":"VIP",
                "assemblyStationCode":12345,
                "assemblyStationName":12345,
                "consentStatus":0,
                "travelDocumentNumber":"A12345",
                "operationalDepartment":"Deck Officer",
                "operationalPosition":"1st Engineer",
                "crewManningNumber":2,
                "safetyPositionCode":2,
                "safetyPositionName":"Master"
            }
        },
        {
            "links":{
                "rel":"resident",
                "href":"http://localhost:8080/spms/v1/resident/12345",
                "method":"get",
                "operationId":"findByID"
            }
        },
        {
            "item":{
                "guestId":12345,
                "title":"Mr",
                "salutation":"MR",
                "firstName":"John",
                "middleName":"Andy",
                "lastName":"Smith",
                "unicodeName":null,
                "dateOfBirth":"1961-04-01",
                "age":57,
                "accountCategory":"PAX",
                "accountType":"System Account Passenger Crew Group Visitor",
                "passportNum":"A01234567",
                "nationalIdNum":123456789,
                "documentIssuedDate":"1961-04-01",
                "documentExpiryDate":"1961-04-01",
                "documentIssuedCountry":"US",
                "countryOfBirth":"US",
                "countryOfResidence":"US",
                "contactNum":"+0123456789",
                "alternativeContactNum":"+0123456789",
                "emailAddress":"EMAIL ADD",
                "emergencyContactName":"John",
                "emergencyContactNum":"+0123456789",
                "gender":"M or F",
                "nationality":"US",
                "reservationAccountReferenceId":12345,
                "reservationStatus":"CC",
                "cabinNum":12345,
                "reservationAccountType":"P",
                "routedAccountNumber":12345,
                "onboardStatus":0,
                "reservationCancelStatus":false,
                "reservationBookingNumber":"0123456789",
                "embarkCruiseId":12345,
                "embarkDate":"2015-09-02",
                "actualEmbarkDate":"2015-09-02",
                "disembarkDate":"2015-09-09",
                "actualDisembarkDate":"null or 2015-09-09",
                "boardCardNumber":123456789,
                "reservationId":12345,
                "accountId":12345,
                "reservationExternalId":12345,
                "embarkPort":123,
                "disembarkPort":123,
                "groupReferenceId":12345,
                "photo":"/Images/People/",
                "setSailPass":12345,
                "assemblyStationCode":12345,
                "groupName":"Smith",
                "consentStatus":0,
                "travelDocumentNumber":"A12345"
            }
        },
        {
            "links":{
                "rel":"visitor",
                "href":"http://localhost:8080/spms/v1/visitor/12345",
                "method":"get",
                "operationId":"findByID"
            }
        },
        {
            "item":{
                "guestId":12345,
                "title":"Mr",
                "salutation":"MR",
                "firstName":"John",
                "middleName":"Andy",
                "lastName":"Smith",
                "dateOfBirth":"1961-04-01",
                "age":57,
                "accountType":"System Account Passenger Crew Group Visitor",
                "passportNum":"A01234567",
                "countryOfBirth":"US",
                "countryOfResidence":"US",
                "contactNum":"+0123456789",
                "emailAddress":"EMAIL ADD",
                "emergencyContactName":"John",
                "emergencyContactNum":"+0123456789",
                "gender":"M or F",
                "nationality":"US",
                "reservationStatus":"CC",
                "reservationAccountType":"P",
                "onboardStatus":0,
                "reservationCancelStatus":false,
                "embarkDate":"2015-09-02",
                "actualEmbarkDate":"2015-09-02",
                "disembarkDate":"2015-09-09",
                "actualDisembarkDate":"null or 2015-09-09",
                "boardCardNumber":123456789,
                "reservationId":12345,
                "accountId":12345,
                "embarkPort":123,
                "photo":"/Images/People/",
                "consentStatus":0,
                "travelDocumentNumber":"A12345",
                "visitorPassType":"DEC10"
            }
        }
    ],
    "limit":10,
    "offset":0
}

204 Response

No content is available

401 Response

You are not authorized to use this API
Body ()
Root Schema : schema
Match All
Show Source
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

403 Response

You are forbidden to use this API
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
    "title":"Forbidden",
    "detail":"Access to this resource was forbidden"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

404 Response

Record not found
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
    "title":"Not Found",
    "detail":"Ship 123 was not found"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

405 Response

This method is not available
Body ()
Root Schema : schema
Match All
Show Source
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

406 Response

Not Acceptable
Body ()
Root Schema : schema
Match All
Show Source
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

500 Response

Error occured while processing this request
Body ()
Root Schema : schema
Match All
Show Source
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

503 Response

Service not available
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
    "title":"Service not available",
    "detail":"Service Unavailable.  Try again later"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source
Back to Top