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

# Poll for search results

`POST /shopping/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-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/c3e56ec8db70/schema)