> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-wen-dang/api-can-kao/yu-ding-hou-api/pnr-ren-ling.md).

# PNR 认领

{% hint style="info" %}
遇到 API 接入问题时，可登录 [Eva](https://www.atriptech.com/) 寻求帮助。
{% endhint %}

## PNR Claim

> \*\*Dependency\*\*\
> No preceding function needs to be carried out.\
> \
> \*\*Endpoint:\*\*\
> <https://sandbox.atriptech.com/pnr/claim.do>

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"security":[],"paths":{"/pnr/claim.do":{"post":{"summary":"PNR Claim","deprecated":false,"description":"**Dependency**\nNo preceding function needs to be carried out.\n\n**Endpoint:**\nhttps://sandbox.atriptech.com/pnr/claim.do","tags":[],"parameters":[{"name":"Accept","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"Content-Type","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"Accept-Encoding","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"x-atlas-client-id","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"x-atlas-client-secret","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"mmb":{"type":"object","properties":{"airlinePnr":{"type":"string","description":"Passenger Name Record generated by the airline."},"email":{"type":"string","description":"Contact email.","nullable":true}},"description":"The information used for loging into traveler’s MMB","required":["airlinePnr"],"nullable":true},"passengers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The passenger's name. Please send it in the following format: Family Name/Given Name"},"passengerType":{"description":"Type of passenger.\n- 0: Adult\n- 1: Child\n- 2: Infant","$ref":"#/components/schemas/PassengerType","nullable":true},"gender":{"type":"string","description":"The passenger's gender.\n- `M`: Male\n- `F`: Female","nullable":true},"birthday":{"type":"string","description":"The passenger's date of birth. Format:`YYYYMMDD`. Please fill in according to the passenger information requirements(`bookingRequirement`) returned by the Verification / Get Offer API.","nullable":true},"cardType":{"type":"string","description":"The type of the identity document.\n- PP: Passport\n- GA: Hong Kong Macau Pass for China mainland citizens\n- TW: Taiwan Pass for China mainland citizens\n- TB: China mainland pass for Taiwanese\n- HY: International Seaman's Certificate","enum":["PP","GA","TW","TB","HY"],"nullable":true},"cardNum":{"type":"string","description":"The unique identifier of the identity document. e.g. the passport number. Please fill in according to the passenger information requirements(`bookingRequirement`) returned by the Verification / Get Offer API.","nullable":true},"cardIssuePlace":{"type":"string","description":"The ISO 3166-1 alpha-2 code for the country where the identity document is issued. Please fill in according to the passenger information requirements(`bookingRequirement`) returned by the Verification / Get Offer API.","nullable":true},"cardExpired":{"type":"string","description":"The date on which the identity document expires. Format:`YYYYMMDD`.Please fill in according to the passenger information requirements(`bookingRequirement`) returned by the Verification / Get Offer API.","nullable":true},"nationality":{"type":"string","description":"The ISO 3166-1 alpha-2 code for the nationality of passenger. Please fill in according to the passenger information requirements(`bookingRequirement`) returned by the Verification / Get Offer API.","nullable":true}},"required":["name"]}},"fromSegments":{"type":"array","items":{"type":"object","properties":{"carrier":{"type":"string","description":"IATA code of the marketing airline"},"flightNumber":{"type":"string","description":"The value denotes the marketing flight number.\nFormat: CA123 or TR021 or FR1290. The letters denote the carrier and the three/four-digit number that follows is the flight number."},"depAirport":{"type":"string","description":"IATA code of the departure airport."},"arrAirport":{"type":"string","description":"IATA code of the arrival airport."},"depTime":{"type":"string","description":"Departure time of the flight. Format:`yyyyMMddHHmm`"},"arrTime":{"type":"string","description":"Arrival time of the flight. Format:`yyyyMMddHHmm`","nullable":true},"stopCities":{"type":"string","description":"Name of cities from where the passengers will take connecting flights. Include IATA code of cities and use a comma in case of multiple cities to separate if transfer airports count is higher than 1. For example: CGK, SUB. Blank means non-stop flight.","nullable":true},"codeShare":{"type":"integer","description":"- 1: code share\n- 0: Not code share","nullable":true},"operatingCarrier":{"type":"string","description":"Operating carrier. It is blank when codeshare=false","nullable":true},"operatingFlightNumber":{"type":"string","description":"Operating flight number. It is blank when codeshare=false","nullable":true},"depTerminal":{"type":"string","description":"Departure Terminal","nullable":true},"arrTerminal":{"type":"string","description":"Arrival Terminal","nullable":true},"cabinClass":{"$ref":"#/components/schemas/CabinClass","nullable":true,"description":"Service grade of the fare"},"fareFamily":{"type":"string","description":"Fare Family as per the information received from the airline.","nullable":true},"duration":{"type":"integer","description":"The flying duration in minutes.","nullable":true}},"required":["carrier","flightNumber","depAirport","arrAirport","depTime"]},"description":"Outbound segments"},"retSegments":{"type":"array","items":{"$ref":"#/components/schemas/PNRClaimFlight"},"description":"Inbound segments","nullable":true},"connectInfo":{"type":"object","properties":{"contactName":{"type":"string","nullable":true},"contactEmail":{"type":"string","nullable":true},"contactPhone":{"type":"string","nullable":true},"useAtlasMailForContact":{"type":"string","nullable":true}},"nullable":true}},"required":["passengers","fromSegments"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"msg":{"type":"string","nullable":true},"orderNo":{"type":"string","description":"Atlas order number"}},"required":["orderNo","status"]}}},"headers":{}}}}}},"components":{"schemas":{"PassengerType":{"type":"integer","enum":[0,1,2]},"CabinClass":{"type":"integer","enum":[1,2,3,4],"title":""},"PNRClaimFlight":{"type":"object","properties":{"carrier":{"type":"string","description":"IATA code of the marketing airline"},"flightNumber":{"type":"string","description":"The value denotes the marketing flight number.\nFormat: CA123 or TR021 or FR1290. The letters denote the carrier and the three/four-digit number that follows is the flight number."},"depAirport":{"type":"string","description":"IATA code of the departure airport."},"arrAirport":{"type":"string","description":"IATA code of the arrival airport."},"depTime":{"type":"string","description":"Departure time of the flight. Format:`yyyyMMddHHmm`"},"arrTime":{"type":"string","description":"Arrival time of the flight. Format:`yyyyMMddHHmm`","nullable":true},"stopCities":{"type":"string","description":"Name of cities from where the passengers will take connecting flights. Include IATA code of cities and use a comma in case of multiple cities to separate if transfer airports count is higher than 1. For example: CGK, SUB. Blank means non-stop flight.","nullable":true},"codeShare":{"type":"integer","description":"- 1: code share\n- 0: Not code share","nullable":true},"operatingCarrier":{"type":"string","description":"Operating carrier. It is blank when codeshare=false","nullable":true},"operatingFlightNumber":{"type":"string","description":"Operating flight number. It is blank when codeshare=false","nullable":true},"depTerminal":{"type":"string","description":"Departure Terminal","nullable":true},"arrTerminal":{"type":"string","description":"Arrival Terminal","nullable":true},"cabinClass":{"$ref":"#/components/schemas/CabinClass","nullable":true,"description":"Service grade of the fare"},"fareFamily":{"type":"string","description":"Fare Family as per the information received from the airline.","nullable":true},"duration":{"type":"integer","description":"The flying duration in minutes.","nullable":true}},"required":["carrier","flightNumber","depAirport","arrAirport","depTime"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://resources.atriptech.com/api-wen-dang/api-can-kao/yu-ding-hou-api/pnr-ren-ling.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.