TUI Group Baggage API

The baggage API from TUI Group — 6 operation(s) for baggage.

Operations 7

POST /api/dcs/v1/baggage Adds baggage to a booking stateless. #
DELETE /api/dcs/v1/baggage Sets the 'Removed' status for a bag for a booking stateless. #
POST /api/dcs/v2/baggage Adds baggage to a booking stateless. #
DELETE /api/dcs/v1/baggage/byLegKey Sets the 'Removed' status for a bag for a booking stateless, by leg key. #
PUT /api/dcs/v1/baggage/checkIn Performs an update and checks-in an individual baggage item for a specific passenger. #
PUT /api/dcs/v2/baggage/checkIn Performs an update and checks-in an individual baggage item for a specific passenger. #
POST /api/dcs/v3/baggage Adds a list of bags to a booking. #

Documentation

📖
Documentation
https://developer.tui/api-catalog/newskies-digital-api/api-description
📖
Documentation
https://developer.tui/api-catalog/newskies-digital-api/get-started
📖
Documentation
https://developer.tui/api-catalog/newskies-digital-api/simple-workflow
📖
Documentation
https://developer.tui/api-catalog/newskies-digital-api/advanced-workflow
📖
Documentation
https://developer.tui/api-catalog/newskies-digital-api/creditcard-payments
📖
Documentation
https://developer.tui/api-catalog/newskies-digital-api/backwards-compatibility
📖
Documentation
https://developer.tui/api-catalog/newskies-gonow-api/api-description
📖
Documentation
https://developer.tui/api-catalog/newskies-gonow-api/get-started
📖
Documentation
https://developer.tui/api-catalog/newskies-gonow-api/check-workflow
📖
Documentation
https://developer.tui/api-catalog/newskies-gonow-api/backwards-compatibility
📖
Documentation
https://developer.tui/api-catalog/newskies-payment-api/api-description
📖
Documentation
https://developer.tui/api-catalog/newskies-payment-api/booking-flow
📖
Documentation
https://developer.tui/api-catalog/nskcc-availability-search-api/description
📖
Documentation
https://developer.tui/api-catalog/nskcc-availability-search-api/api-details
📖
Documentation
https://developer.tui/api-catalog/nskcc-availability-search-api/technical-integration
📖
Documentation
https://developer.tui/api-catalog/nskcc-availability-search-api/code-examples
📖
Documentation
https://developer.tui/api-catalog/nskcc-availability-search-api/api-onepager
📖
Documentation
https://developer.tui/api-catalog/tui-newskies-pricefile-api/description
📖
Documentation
https://developer.tui/api-catalog/tui-newskies-pricefile-api/technical-integration
📖
Documentation
https://developer.tui/api-catalog/tui-newskies-pricefile-api/data-format
📖
Documentation
https://developer.tui/api-catalog/checkinhandler-service-api/api-description
📖
Documentation
https://developer.tui/api-catalog/checkinhandler-service-api/api-details
📖
Documentation
https://developer.tui/api-catalog/checkinhandler-service-api/technical-integration
📖
Documentation
https://developer.tui/api-catalog/tui-flight-ota-api/api-description
📖
Documentation
https://developer.tui/api-catalog/ota-content-api/api-description
📖
Documentation
https://developer.tui/api-catalog/ota-content-api/technical-details
📖
Documentation
https://developer.tui/api-catalog/ota-content-api/release-notes
📖
Documentation
https://developer.tui/api-catalog/walldy-api/api-description
📖
Documentation
https://developer.tui/api-catalog/walldy-api/api-details
📖
Documentation
https://developer.tui/api-catalog/walldy-api/technical-integration
📖
Documentation
https://developer.tui/api-catalog/walldy-api/api-onepager
📖
Documentation
https://developer.tui/api-catalog/walldy-api/release-notes
📖
Documentation
https://developer.tui/api-catalog/holidayofferscontroller-api/api-description
📖
Documentation
https://developer.tui/api-catalog/holidayofferscontroller-api/technical-integration
📖
Documentation
https://developer.tui/api-catalog/holidayofferscontroller-api/release-notes
📖
Documentation
https://developer.tui/api-catalog/meta-search-generic-api/api-description
📖
Documentation
https://developer.tui/api-catalog/partner-content-api/api-description
📖
Documentation
https://developer.tui/api-catalog/ship-content-api/api-description

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/tui-group-baggage-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tui-group-baggage-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Tui Group Baggage API
  version: '1.0'
  description: 'Operations tagged baggage across 2 of this provider''s published API definitions: tui-group-tui-newskies-digital-api-openapi.yml, tui-group-tui-newskies-gonow-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://prod.api.tui/flight/newskies/rest
  description: TUI Prod
- url: https://playground.api.tui/flight/newskies/rest
  description: TUI Playground
- url: https://prod.api.tui/flight/newskies/gonow
  description: TUI Prod
- url: https://playground.api.tui/flight/newskies/gonow
  description: TUI Playground
security:
- JWT: []
tags:
- name: baggage
paths:
  /api/dcs/v1/baggage:
    post:
      tags:
      - baggage
      summary: Adds baggage to a booking stateless.
      description: 'Agent only. Requires the booking to be committed.

        If you have the booking in state you will need to re-retrieve it to see the added baggage.

        IMPORTANT: This endpoint should NOT be called concurrently using the same session token to avoid performance

        problems.


        GraphQL endpoint: baggageAdd'
      operationId: dcs_v1_baggage_post
      requestBody:
        x-name: request
        description: A request to add bags to the given passenger.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddBaggageRequest'
            examples:
              Journey Bag Check-in:
                description: Example request for adding a bag to a booking.
                value:
                  recordLocator: I3NTYF
                  journeyKey: TlZ_NTYyNn4gfn5TTEN_MDcvMjYvMjAyNSAwNjowMH5ERU5_MDcvMjYvMjAyNSAwNzowMH5_Xk5WfjU2MjJ_IH5_REVOfjA3LzI2LzIwMjUgMDg6MDB_Qk9TfjA3LzI2LzIwMjUgMTQ6MDB_fg--
                  passengerKey: MCFBRFQ-
                  iataIdentifier: 091
                  nonStandard: false
                  allowBaggageOnNonHosted: true
                  baggageInformation:
                    type: BA20
                    manualBagTag: false
                    osTag: SLC987654
                    weight: 10
                    weightType: 1
        required: true
        x-position: 1
      responses:
        '201':
          description: Created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
              examples:
                Add Baggage Successful:
                  description: Example when baggage is added successfully
                  value:
                    data: null
                Add Baggage Failed With Specific Error Message:
                  description: Example when baggage is not added successfully because segment status is Closed/ClosedPending/Cancelled/BlockAllActivities. A 201 Created is still returned even though the baggage was not added.
                  value:
                    messages:
                    - rawValue: 'The system has returned an error message for adding a bag with passenger key ''MCFBRFQ-'' and journey key ''TlZ_MjI0MX4gfn5TTEN_MDYvMjgvMjAyNCAxMzoxNX5ERU5_MDYvMjgvMjAyNCAxNTozMH5_Xk5WfiA3ODl_IH5_REVOfjA2LzI4LzIwMjQgMTY6MzB_Qk9TfjA2LzI4LzIwMjQgMjI6MDB_fg--''.  The message is: ''Flight 2241 SLCBOS has been cancelled, request not processed.''.'
                      code: dcs:Baggage:BaggageAddError
                      debugMode: The API is currently running in debug mode. In production the 'rawValue' node will not be returned. These are for troubleshooting development issues only.
                      type: Warning
                      value: dcs:Baggage:BaggageAddError
                      status: 1
                      details:
                        journeyKey: TlZ_MjI0MX4gfn5TTEN_MDYvMjgvMjAyNCAxMzoxNX5ERU5_MDYvMjgvMjAyNCAxNTozMH5_Xk5WfiA3ODl_IH5_REVOfjA2LzI4LzIwMjQgMTY6MzB_Qk9TfjA2LzI4LzIwMjQgMjI6MDB_fg--
                        passengerKey: MCFBRFQ-
                    data: null
        '400':
          description: There was a problem with the request and it could not be completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
              examples:
                Invalid Record Locator Error:
                  description: Example error when record locator is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        recordLocator: 9SkFNRegdQRYuQ3YfA2g9
                      rawMessage: The identifier 'RecordLocator' with value '9SkFNRegdQRYuQ3YfA2g9' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Passenger Key Error:
                  description: Example error when passenger key is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        passengerKey: JoKwkYODu4gNYRwNQo
                      rawMessage: The identifier 'PassengerKey' with value 'JoKwkYODu4gNYRwNQo' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Journey Key Error:
                  description: Example error when journey key is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        journeyKey: JoKwkYODu4gNYRwNQo
                      rawMessage: The identifier 'JourneyKey' with value 'JoKwkYODu4gNYRwNQo' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Baggage Type Code Error:
                  description: Example error when baggage type code is invalid.
                  value:
                    errors:
                    - id: 1a68ef3e-44b5-08d4-9395-e69695467a5d
                      code: dcs:Baggage:InvalidBaggageTypeCode
                      message: dcs:Baggage:InvalidBaggageTypeCode
                      type: Validation
                      details: null
                      rawMessage: The baggage type code 'BA20' is not valid or is inactive for the current environment.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Add Baggage Failure Without Specific Message:
                  description: Example error when add baggage fails in New Skies without a specific error message.
                  value:
                    errors:
                    - id: 693b6295-6ae8-a005-9f1e-1e1d1600d573
                      code: dcs:Exceptions:CreateFailed
                      message: dcs:Exceptions:CreateFailed
                      type: Validation
                      details: null
                      rawMessage: Attempted create of object 'AddBaggageRequest' has failed. Please verify this object does not already exist.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Add Baggage Failure With Specific Message:
                  description: Example error when add baggage fails in New Skies with a specific error message.
                  value:
                    errors:
                    - id: 693b6295-6ae8-a005-9f1e-1e1d1600d573
                      code: dcs:Exceptions:CreateFailed
                      message: dcs:Exceptions:CreateFailed
                      type: Validation
                      details: null
                      rawMessage: Attempted create of object 'AddBaggageRequest' has failed. Please verify this object does not already exist.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    messages:
                    - rawValue: 'The system has returned an error message for adding a bag with passenger key ''MCFBRFQ-'' and journey key ''TlZ_MjI0MX4gfn5TTEN_MDYvMjgvMjAyNCAxMzoxNX5ERU5_MDYvMjgvMjAyNCAxNTozMH5_Xk5WfiA3ODl_IH5_REVOfjA2LzI4LzIwMjQgMTY6MzB_Qk9TfjA2LzI4LzIwMjQgMjI6MDB_fg--''.  The message is: ''Flight 2241 SLCBOS has been cancelled, request not processed.''.'
                      code: dcs:Baggage:BaggageAddError
                      debugMode: The API is currently running in debug mode. In production the 'rawValue' node will not be returned. These are for troubleshooting development issues only.
                      type: Warning
                      value: dcs:Baggage:BaggageAddError
                      status: 1
                      details:
                        journeyKey: TlZ_MjI0MX4gfn5TTEN_MDYvMjgvMjAyNCAxMzoxNX5ERU5_MDYvMjgvMjAyNCAxNTozMH5_Xk5WfiA3ODl_IH5_REVOfjA2LzI4LzIwMjQgMTY6MzB_Qk9TfjA2LzI4LzIwMjQgMjI6MDB_fg--
                        passengerKey: MCFBRFQ-
                    data: null
        '401':
          description: Authorization Not Allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '409':
          description: Concurrent changes were being made in the same session.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
      deprecated: true
    delete:
      tags:
      - baggage
      summary: Sets the 'Removed' status for a bag for a booking stateless.
      description: 'Agent only. Requires the booking to be committed.

        IMPORTANT: This endpoint should NOT be called concurrently using the same session token to avoid performance

        problems.


        GraphQL endpoint: baggageRemove'
      operationId: dcs_v1_baggage_delete
      requestBody:
        x-name: request
        description: A request to set bag status as 'Removed' for the provided passenger bag.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveBaggageRequest'
        required: true
        x-position: 1
      responses:
        '200':
          description: OK. Request completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '400':
          description: There was a problem with the request and it could not be completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '401':
          description: Authorization Not Allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '409':
          description: Concurrent changes were being made in the same session.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
    servers:
    - url: https://prod.api.tui/flight/newskies/rest
      description: TUI Prod
    - url: https://playground.api.tui/flight/newskies/rest
      description: TUI Playground
  /api/dcs/v2/baggage:
    post:
      tags:
      - baggage
      summary: Adds baggage to a booking stateless.
      description: 'Agent only. Requires the booking to be committed.

        If you have the booking in state you will need to re-retrieve it to see the added baggage.

        IMPORTANT: This endpoint should NOT be called concurrently using the same session token to avoid performance

        problems.


        GraphQL endpoint: baggageAddv2'
      operationId: dcs_v2_baggage_post
      requestBody:
        x-name: request
        description: A request to add bags to the given passenger.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddBaggageRequest'
            examples:
              Journey Bag Check-in:
                description: Example request for adding a bag to a booking.
                value:
                  recordLocator: I3NTYF
                  journeyKey: TlZ_NTYyNn4gfn5TTEN_MDcvMjYvMjAyNSAwNjowMH5ERU5_MDcvMjYvMjAyNSAwNzowMH5_Xk5WfjU2MjJ_IH5_REVOfjA3LzI2LzIwMjUgMDg6MDB_Qk9TfjA3LzI2LzIwMjUgMTQ6MDB_fg--
                  passengerKey: MCFBRFQ-
                  iataIdentifier: 091
                  nonStandard: false
                  allowBaggageOnNonHosted: true
                  baggageInformation:
                    type: BA20
                    manualBagTag: false
                    osTag: SLC987654
                    weight: 10
                    weightType: 1
        required: true
        x-position: 1
      responses:
        '201':
          description: Created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
              examples:
                Add Baggage Successful:
                  description: Example when baggage is added successfully
                  value:
                    data: null
        '400':
          description: Adding bag failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
              examples:
                Invalid Record Locator Error:
                  description: Example error when record locator is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        recordLocator: 9SkFNRegdQRYuQ3YfA2g9
                      rawMessage: The identifier 'RecordLocator' with value '9SkFNRegdQRYuQ3YfA2g9' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Passenger Key Error:
                  description: Example error when passenger key is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        passengerKey: JoKwkYODu4gNYRwNQo
                      rawMessage: The identifier 'PassengerKey' with value 'JoKwkYODu4gNYRwNQo' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Journey Key Error:
                  description: Example error when journey key is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        journeyKey: JoKwkYODu4gNYRwNQo
                      rawMessage: The identifier 'JourneyKey' with value 'JoKwkYODu4gNYRwNQo' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Baggage Type Code Error:
                  description: Example error when baggage type code is invalid.
                  value:
                    errors:
                    - id: 1a68ef3e-44b5-08d4-9395-e69695467a5d
                      code: dcs:Baggage:InvalidBaggageTypeCode
                      message: dcs:Baggage:InvalidBaggageTypeCode
                      type: Validation
                      details: null
                      rawMessage: The baggage type code 'BA20' is not valid or is inactive for the current environment.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                All Bags Fail Without Specific Message:
                  description: Example error when add baggage fail in New Skies without a specific error message.
                  value:
                    errors:
                    - id: 693b6295-6ae8-a005-9f1e-1e1d1600d573
                      code: dcs:Exceptions:CreateFailed
                      message: dcs:Exceptions:CreateFailed
                      type: Validation
                      details: null
                      rawMessage: Attempted create of object 'AddBaggageRequest' has failed. Please verify this object does not already exist.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Add Baggage Failure With Specific Message:
                  description: Example error when add baggage fails in New Skies with a specific error message.
                  value:
                    errors:
                    - id: 693b6295-6ae8-a005-9f1e-1e1d1600d573
                      code: dcs:Exceptions:CreateFailed
                      message: Flight 2241 SLCBOS has been cancelled, request not processed.
                      type: Error
                      details:
                        journeyKey: TlZ_NTYxNH4gfn5TTEN_MDYvMjgvMjAyNCAwMzowMH5ERU5_MDYvMjgvMjAyNCAwNDowMH5_Xk5WfjU2MTV_IH5_REVOfjA2LzI4LzIwMjQgMDg6MDB_Qk9TfjA2LzI4LzIwMjQgMTM6MDB_fg--
                        passengerKey: MCFBRFQ-
                        errorMessage: Flight 2241 SLCBOS has been cancelled, request not processed.
                      rawMessage: Flight 2241 SLCBOS has been cancelled, request not processed.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
        '401':
          description: Authorization Not Allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
    servers:
    - url: https://prod.api.tui/flight/newskies/rest
      description: TUI Prod
    - url: https://playground.api.tui/flight/newskies/rest
      description: TUI Playground
  /api/dcs/v1/baggage/byLegKey:
    delete:
      tags:
      - baggage
      summary: Sets the 'Removed' status for a bag for a booking stateless, by leg key.
      description: 'Agent only. Requires the booking to be committed.

        IMPORTANT: This endpoint should NOT be called concurrently using the same session token to avoid performance

        problems.

        All downline legs and segments will have the bag status marked as `Removed` as well.

        If you want to remove the bag for a whole journey, just pass in the first leg key.


        GraphQL endpoint: baggageRemoveByLegKey'
      operationId: dcs_v1_baggage_byLegKey_delete
      requestBody:
        x-name: request
        description: A request to set bag status as 'Removed' for the provided passenger bag.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RemoveBaggageByLegKeyRequest'
        required: true
        x-position: 1
      responses:
        '200':
          description: OK. Request completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '400':
          description: There was a problem with the request and it could not be completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
              examples:
                Invalid passenger key error:
                  description: Example error when passenger key is invalid.
                  value:
                    errors:
                    - id: null
                      code: nsk:Exceptions:InvalidKey
                      message: The identifier 'PassengerKey' with value 'tW' is invalid.
                      type: Validation
                      details:
                        passengerKey: tW
                      rawMessage: null
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid leg key error:
                  description: Example error when leg key is invalid.
                  value:
                    errors:
                    - id: null
                      code: nsk:Exceptions:InvalidKey
                      message: The identifier 'LegKey' with value '76oyA0KoZ0gsjHX' is invalid.
                      type: Validation
                      details:
                        legKey: 76oyA0KoZ0gsjHX
                      rawMessage: null
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid baggage key error:
                  description: Example error when baggage key is invalid.
                  value:
                    errors:
                    - id: null
                      code: nsk:Exceptions:InvalidKey
                      message: The identifier 'BaggageKey' with value 'upvbqtl' is invalid.
                      type: Validation
                      details:
                        baggageKey: upvbqtl
                      rawMessage: null
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid record locator error:
                  description: Example error when the record locator invalid.
                  value:
                    errors:
                    - id: null
                      code: nsk:Exceptions:InvalidKey
                      message: The identifier 'RecordLocator' with value 'n02' is invalid.
                      type: Validation
                      details:
                        recordLocator: n02
                      rawMessage: null
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
        '401':
          description: Authorization Not Allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '409':
          description: Concurrent changes were being made in the same session.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
    servers:
    - url: https://prod.api.tui/flight/newskies/rest
      description: TUI Prod
    - url: https://playground.api.tui/flight/newskies/rest
      description: TUI Playground
  /api/dcs/v1/baggage/checkIn:
    put:
      tags:
      - baggage
      summary: Performs an update and checks-in an individual baggage item for a specific passenger.
      description: 'If the journey key is set on the request, the request will process all segments associated with the journey,

        and will ignore the segment key value.

        The baggage type code can only be updated if the baggage weight is changed as well, and if the baggage type code is

        a valid, active baggage type in the current environment.

        Please note, this call does NOT sync with the booking baggage allowances and usages.

        IMPORTANT: This endpoint should NOT be called concurrently using the same session token to avoid performance

        problems.


        GraphQL endpoint: baggageSet'
      operationId: dcs_v1_baggage_checkIn_put
      requestBody:
        x-name: request
        description: The passenger bag edit request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PassengerBagEditRequest'
            examples:
              Journey Bag Check-in:
                description: Example request for checking in a bag for a journey
                value:
                  allowBaggageOnNonHosted: true
                  weight: 20
                  processAsIatci: false
                  baggageCount: 2
                  baggageTypeCode: 1BAG
                  segmentKey: null
                  journeyKey: TlZ_NTYyNn4gfn5TTEN_MDcvMjYvMjAyNSAwNjowMH5ERU5_MDcvMjYvMjAyNSAwNzowMH5_Xk5WfjU2MjJ_IH5_REVOfjA3LzI2LzIwMjUgMDg6MDB_Qk9TfjA3LzI2LzIwMjUgMTQ6MDB_fg--
                  passengerKey: MCFBRFQ-
                  baggageKey: MDAyODA0MTMzMQ--
                  recordLocator: I3NTYF
              Segment Bag Check-in:
                description: Example request for checking in a bag for a segment
                value:
                  allowBaggageOnNonHosted: true
                  weight: 21
                  processAsIatci: false
                  baggageCount: 2
                  baggageTypeCode: 1BAG
                  segmentKey: TlZ_MjAwNH4gfn5TTEN_MDgvMDEvMjAyNSAwMTo1OX5KRkt_MDgvMDEvMjAyNSAwNDowMH5_
                  journeyKey: null
                  passengerKey: MCFBRFQ-
                  baggageKey: MDg4ODA1NTEzMA--
                  recordLocator: T4VBGC
        required: true
        x-position: 1
      responses:
        '200':
          description: OK. Request completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
        '400':
          description: There was a problem with the request and it could not be completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IJsonResponse'
              examples:
                Invalid Record Locator Error:
                  description: Example error when record locator is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        recordLocator: 9SkFNRegdQRYuQ3YfA2g9
                      rawMessage: The identifier 'RecordLocator' with value '9SkFNRegdQRYuQ3YfA2g9' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Passenger Key Error:
                  description: Example error when passenger key is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        passengerKey: JoKwkYODu4gNYRwNQo
                      rawMessage: The identifier 'PassengerKey' with value 'JoKwkYODu4gNYRwNQo' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Invalid Journey Key Error:
                  description: Example error when journey key is invalid.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: nsk:Exceptions:InvalidKey
                      message: nsk:Exceptions:InvalidKey
                      type: Validation
                      details:
                        journeyKey: JoKwkYODu4gNYRwNQo
                      rawMessage: The identifier 'JourneyKey' with value 'JoKwkYODu4gNYRwNQo' is invalid.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Journey and Segment Keys Not Provided:
                  description: Example error when neither journey key or segment key are provided.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: dcs:Baggage:JourneyOrSegmentKeyRequired
                      message: dcs:Baggage:JourneyOrSegmentKeyRequired
                      type: Validation
                      details: null
                      rawMessage: Either the journey key or the segment key is required for this operation.
                      exception: null
                      debugMode: The API is currently running in debug mode. In production the 'rawMessage' and 'exception' nodes will not be returned. These are for troubleshooting development issues only.
                    data: null
                Changing Type Code But Not Weight:
                  description: Example error when the baggage type code cannot be changed because the baggage weight did not change.
                  value:
                    errors:
                    - id: 2f5dd7f3-47f7-48fb-a180-f9152278605f
                      code: ndcs:Baggage:UnableToChangeBaggageTypeCode
                      message: dcs:Baggage:UnableToChangeBaggageTypeCode
               

# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tui-group/refs/heads/main/openapi/tui-group-baggage-api-openapi.yml