Journey

Managing journey with or without DCS.

Load journey from BCBP payload

Operation POST /v2/journeys/from-bcbp

Headers

Scheme Structure St Rep Comments

X-Source-App-Key

Header

M

1

Issued client key

bearerAuth

HTTP Bearer (JWT)

M

1

Access token

Body (JourneyAddWithBcbpRequest)

Field Structure St Rep Comments

scanData

String

M

1

Bar-coded boarding pass (BCBP) string

airline

String

O

0..1

Optional airline hint

Request example

{
  "scanData": "M1LOVELACE/ADA EABC123 OSLARNSK 1234 123Y08A1234 100",
  "airline": "SK"
}

Responses

200 OK (JourneyResponse)

Example:

{
  "recordLocator": "ABC123",
  "journeyId": 2002,
  "passenger": {
    "passengerId": 1,
    "givenName": "Ada",
    "surname": "Lovelace"
  },
  "baggageSlots": [],
  "flights": [],
  "version": 1,
  "departureAirport": "OSL",
  "destinationAirport": "ARN"
}

400 BAD_REQUEST / 401 UNAUTHORIZED / 422 UNPROCESSABLE_ENTITY (ErrorResponse)

{
  "status": "400 BAD_REQUEST",
  "statusCode": 400,
  "message": "BCBP decode failed",
  "errorCode": "invalid_bcbp_format",
  "errors": [
    "BCBP decode failed"
  ]
}

Generate or submit baggage tag for journey

Operation POST /v2/journeys/{journeyId}/baggage-tags

Path parameters

Parameter Structure St Rep Comments

journeyId

Integer (int32)

M

1

Journey id

Headers

Scheme Structure St Rep Comments

X-Source-App-Key

Header

M

1

Issued client key

bearerAuth

HTTP Bearer (JWT)

M

1

Access token

Body (GenerateBagTagModel)

Field Structure St Rep Comments

passengerList

Array of PassengerDTO

M

1..n

Passengers to generate tags for

lpn

String

O

0..1

License plate / LPN if applicable

slotNumber

Integer (int32)

O

0..1

Selected baggage slot index

Request example

{
  "passengerList": [
    {
      "passengerId": 1,
      "givenName": "Ada",
      "surname": "Lovelace",
      "selected": true
    }
  ],
  "slotNumber": 1
}

Responses

200 OK (JourneyResponse)

Example:

{
  "journeyId": 2002,
  "recordLocator": "ABC123",
  "baggageSlots": [
    {
      "index": 1,
      "baggage": {
        "baggageId": 5001,
        "bagtagHumanReadable": "0012345678901",
        "licenseplate": "0012345678901",
        "createdByBagId": true
      }
    }
  ],
  "version": 2
}

400 BAD_REQUEST / 401 UNAUTHORIZED / 422 UNPROCESSABLE_ENTITY (ErrorResponse)

{
  "status": "422 UNPROCESSABLE_ENTITY",
  "statusCode": 422,
  "message": "No baggage allowance",
  "errorCode": "lpn_not_cancellable",
  "errors": [
    "No baggage allowance"
  ]
}

Create one journey per passenger from airline payload (without DCS)

To be used when all information can be given to check-in platform, with no need for DCS integration.

Operation POST /v2/journeys/from-airline-payload

Headers

Scheme Structure St Rep Comments

X-Source-App-Key

Header

M

1

Issued client key

bearerAuth

HTTP Bearer (JWT)

M

1

Access token

Body (JourneyFromAirlinePayloadRequest)

Field Structure St Rep Comments

passengers

Array of JourneyFromAirlinePassengerPayload

M

1..n

One journey per passenger

JourneyFromAirlinePassengerPayload

Field Structure St Rep Comments

passenger

PassengerDTO

M

1

Passenger details

pnr

String

M

1

Record locator

surname

String

M

1

Passenger surname

flights

Array of JourneyFlightDTO

M

1..n

Flight segments

baggage

Array of AirlineBaggageCreateRequest

O

0..n

Optional inline baggage

Request example (abbreviated)

{
  "passengers": [
    {
      "passenger": {
        "passengerId": 1,
        "givenName": "Ada",
        "surname": "Lovelace",
        "title": "MS"
      },
      "pnr": "ABC123",
      "surname": "Lovelace",
      "flights": [
        {
          "flightId": "SK123",
          "sequence": 1,
          "departureAirport": "OSL",
          "destinationAirport": "ARN",
          "scheduledDepartureTime": "2026-04-08T10:00:00Z"
        }
      ],
      "baggage": [
        {
          "baggageTagNumber": "0012345678901",
          "airline": "SK",
          "destinationAirport": "ARN"
        }
      ]
    }
  ]
}

Responses

200 OK — Array of JourneyResponse

Returns an array with one JourneyResponse per passenger (minItems: 1).

Example:

[
  {
    "recordLocator": "ABC123",
    "journeyId": 1001,
    "passenger": {
      "passengerId": 1,
      "givenName": "Ada",
      "surname": "Lovelace"
    },
    "flights": [],
    "baggageSlots": [],
    "version": 1
  }
]

400 BAD_REQUEST / 401 UNAUTHORIZED / 422 UNPROCESSABLE_ENTITY (ErrorResponse)

{
  "status": "422 UNPROCESSABLE_ENTITY",
  "statusCode": 422,
  "message": "Validation failed",
  "errorCode": "required_info_not_provided",
  "errors": [
    "passengers[0].flights must not be empty"
  ]
}

Create baggage from airline app (without DCS)

Operation POST /v2/journeys/{journeyId}/airline-baggages

Path parameters

Parameter Structure St Rep Comments

journeyId

Integer (int32)

M

1

Journey id

Headers

Scheme Structure St Rep Comments

X-Source-App-Key

Header

M

1

Issued client key

bearerAuth

HTTP Bearer (JWT)

M

1

Access token

Body (AirlineBaggageCreateRequest)

Field Structure St Rep Comments

baggageTagNumber

String

M

1

Airline-issued tag number

airline

String

M

1

Airline designator

destinationAirport

String

M

1

Destination IATA code

Request example

{
  "baggageTagNumber": "0012345678901",
  "airline": "SK",
  "destinationAirport": "ARN"
}

Responses

201 Created (JourneyResponse)

Example:

{
  "journeyId": 2002,
  "baggageSlots": [
    {
      "index": 1,
      "baggage": {
        "baggageId": 6002,
        "bagtagHumanReadable": "0012345678901",
        "createdByBagId": false
      }
    }
  ],
  "version": 3
}

400 BAD_REQUEST / 401 UNAUTHORIZED / 404 NOT_FOUND / 422 UNPROCESSABLE_ENTITY (ErrorResponse)

{
  "status": "404 NOT_FOUND",
  "statusCode": 404,
  "message": "Journey not found",
  "errorCode": "journey_not_found_for_user",
  "errors": [
    "Journey not found"
  ]
}