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

# Poll for search results

`POST /shopping/polls`

A `PollResponse` containing full or partial search results will be returned, given a valid `PollRequest` including a `requestId`.

Corresponding response status code indicates whether another poll is neccessary until all results are returned.

## Request body

- PollRequest — todo
  - `requestId` string, required — This is the request ID found in the `SearchResponse`.
  - `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
>
> All have been returned. There is no more result available.

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

## Other responses

- `206` — Partial > > There are more results available to be polled for the same `PollRequest`.
- `400` — Partial > > There are more results available to be polled for the same `PollRequest`.

## Changes

- **2026-07-14** `5e3990fa16fa` — 3 info
  - added the optional property `trips/items/prices/extended` to the response with the `200` status
  - added the optional property `trips/items/prices/extended` to the response with the `206` status
  - added the optional property `trips/items/prices/extended` to the response with the `400` status
- **2021-12-02** `798c0ab06c96` — 3 info
  - added the optional property `trips/items/flights/items/flightKey` to the response with the `200` status
  - added the optional property `trips/items/flights/items/flightKey` to the response with the `206` status
  - added the optional property `trips/items/flights/items/flightKey` to the response with the `400` status
- **2021-11-12** `c3e56ec8db70` — 1 info
  - endpoint added
- **2021-07-20** `704267da2188` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/newpathfly/apis/virtual-interlining-api/changes/shopping/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/5e3990fa16fa/schema)