Migration quick guide
This guide gives you a quick breakdown of all the changes on one page so you can convert over a lot faster than following the stepped guide.
Convert /search/create
| Step | v1.0 (before) | v3 (after) | |
|---|---|---|---|
| 1. Endpoint | POST https://partners.api.skyscanner.net/apiservices/pricing/v1.0 | POST https://partners.api.skyscanner.net/apiservices/v3/flights/live/search/create | |
| 2. API key | Add apikey attribute in x-www-form-urlencoded body in request | Add x-api-key header in request | |
| 3. Query data | Add in rest of form attributes (country, currency, adults etc) in the body | Add query in JSON format. Find more about the Query object | |
| 4. Status code | Receive a 201 created response with an empty body | Receive a 200 OK response with a response body. | |
| 5. Session token | In the response Location header, copy the link to call poll search. | Save the value from the SessionToken attribute from the response body. We will need this for /search/poll |
Convert /search/poll
| Step | v1.0 (before) | v3 (after) |
|---|---|---|
| 1. Endpoint | GET https://partners.api.skyscanner.net/apiservices/pricing/uk1/v1.0/da575976-20be-4076-8a80-f136cfc4ed39-c1 | POST https://partners.api.skyscanner.net/apiservices/v3/flights/live/search/poll |
| 2. Session Token | Nothing required, session token already included (when we copied the link from Location header) | Add session token from response to url POST https://partners.api.skyscanner.net/apiservices/v3/flights/live/search/poll/{SessionToken} |
| 3. API key | As a query parameter - GET https://partners.api.skyscanner.net/apiservices/pricing/uk1/v1.0/{SessionToken}?apikey=prtl6749387986743898559646983194 | Add x-api-key header in request - x-api-key: {your-api-key} |
| 4. Status code | Receive a 200 OK response with flight details | Receive a 200 OK response with flight details |
| 5. Response status | Poll until Status: UpdatesComplete in response body | Poll until status: RESULT_STATUS_COMPLETE in response body |