Document List API Reference

Get

documents/documentlist/{LocatorCode}

Base path:

The base path for this API varies from that for other JSON Air APIs and does not include air at the end.

Pre-production https://api.pp.travelport.net/11/

Production https://api.travelport.net/11/

Travelport has updated all JSON API authentication and authorization endpoints. Previous pre-production endpoints were deprecated 5 Dec 2025. Previous production endpoints are scheduled for deprecation 30 Jan 2026. API transactions using these endpoints after these dates in those environments will fail. See Endpoint Migration for details.

Related Content: Air Booking Guide

Document List retrieves a list of tickets, invoices, MCOs, and EMDs associated with a record locator. The request can retrieve this information even after the booking and associated documents are purged from the airline's database. Unlike Document History, Document List does not return details of the documents; instead it returns each document's type, status, transaction date, and PCC.

The JSON Air APIs provide the following APIs to retrieve bookings and tickets:

  • To retrieve all booking details, use Reservation Retrieve. Returns all booking, payment, and ticketing information currently on a booking,

  • To retrieve a list of all ticket numbers on a reservation, use Ticket List.

  • To retrieve details for all tickets associated with a record locator (GDS only), or for a single ticket for NDC, use Ticket Retrieve.

  • To return a list of documents on a booking, including tickets, invoices, MCOs, and EMDs, use Document List.

  • To return histories of up to six documents on with a booking, including tickets, invoices, MCOs, and EMDs, use Document History.

Request

As part of the request requirements, also see Authentication and Common Air Headers.

Query Parameters

None.

Request Body

None.

Response

Object

Description

DocumentHistoryListResponse

Top-level object for response. Includes the documentHistoryList object.

documentHistoryList

Array. One instance returned for each document associated with the record locator provided in the endpoint. Includes the documentListSummary object.

Key value pairs:

name: Passenger name associated with the document.

documentListSummary

Document details.

Key value pairs; not all are applicable to and returned for all types of documents:

platingAirline: Code of the plating airline of this document.

number: Document number, such as a 13-digit ticket number or 9-digit invoice number.

documentType: Enum. Document type. Supported values and meanings:

  • E: GDS ticket

  • N: NDC ticket

  • M: MCO (miscellaneous change order)

  • F: Service fee

  • I: Invoice

  • D: GDS EMD

  • C: NDC EMD

actionStatus: Enum. Status of the document. Supported values and meanings:

  • I: Issue

  • R: Refund

  • RC: Refund cancel

  • V: Void

  • VE: Void Exchange

  • E: Exchange

transactionDateTimeUTC: Transaction date and time stamp in UTC.

pseudoCityCode: PCC associated with the document.

Example Request

This request has no message payload.

Example Response

For additional examples, download the developer toolkits and see Using Postman and Developer Toolkits.
{
 "DocumentHistoryListResponse": {
  "@type": "DocumentHistoryListResponse",
  "documentHistoryList": [
   {
    "name": "GATER/ALLIE",
    "documentListSummary": [
     {
      "platingAirline": "VA",
      "number": "7959905312628",
      "documentType": "E",
      "actionStatus": "I",
      "transactionDateTimeUTC": "2025-06-19T20:34:00.000Z",
      "pseudoCityCode": "XB7"
     }
    ]
   },
   {
    "name": "GATER/ALLIE",
    "documentListSummary": [
     {
      "platingAirline": "VA",
      "number": "7959905312629",
      "documentType": "E",
      "actionStatus": "E",
      "transactionDateTimeUTC": "2025-06-19T20:39:00.000Z",
      "pseudoCityCode": "XB7"
     }
    ]
   },
   {
    "name": "GATER/ALLIE",
    "documentListSummary": [
     {
      "number": "122484",
      "documentType": "I",
      "transactionDateTimeUTC": "2025-06-19T20:39:00.000Z",
      "pseudoCityCode": "XB7"
     }
    ]
   }
  ]
 }
}