---
title: "Poll for search results"
method: POST
path: "/polls"
tags: ["Shopping"]
---

# Poll for search results

`POST /polls`

Given a `requestId` obtained from search, corresponding search results will be returned in full (NOT incremental). Different response status code indicates whether another poll is neccessary until entire full results are returned.

## Request body

- SearchResultPoll — This is the payload to be sent when calling `/polls` endpoint. The virtual interlining engine will mostly likely keep generating results at the backend, so stop calling this endpoint when number of results is good enough as a general practice.
  - `requestId` string, required — This is the request ID for which to be polled.
  - `offset` integer — This is the offset of the results to be polled next.
  - `size` integer — This is the maximum number of results to be polled. The actual number of results might be less when there is no more results available at the moment.
  - `currency` string — Currency code of results to be polled.

## Response `200`

OK

- PollResponse
  - `message` string — message returned by server side if there is any

## Other responses

- `206` — Partial
- `400` — Bad Request

## Changes

- **2021-10-06** `422128cc2430` — 6 info
  - the response optional property `trips/items/flights/items/segments/items/arrDate` became not read-only for the status `200`
  - the response optional property `trips/items/flights/items/segments/items/arrDate` became not read-only for the status `206`
  - the response optional property `trips/items/flights/items/segments/items/arrDate` became not read-only for the status `400`
  - the response optional property `trips/items/segmentGroups/items/segments/items/arrDate` became not read-only for the status `200`
  - …2 more
- **2021-09-28** `e0e4c01254e9` — 6 info
  - removed the `All` enum value from the `trips/items/flights/items/segments/items/fareClass` response property for the response status `200`
  - removed the `All` enum value from the `trips/items/flights/items/segments/items/fareClass` response property for the response status `206`
  - removed the `All` enum value from the `trips/items/flights/items/segments/items/fareClass` response property for the response status `400`
  - removed the `All` enum value from the `trips/items/segmentGroups/items/segments/items/fareClass` response property for the response status `200`
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/changes/polls/post.md)

---

[API](https://skmtc.dev/newpathfly/apis/virtual-interlining-api.md) · [All operations](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newpathfly/virtual-interlining-api/revisions/422128cc2430/schema)