---
title: "Poll a queued request"
method: GET
path: "/v1/requests/{id}"
tags: ["Sources"]
---

# Poll a queued request

`GET /v1/requests/{id}`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/requests/{id}`
- Auth: none required

States are queued, live, or declined. Live means rows are ready; declined means stop polling. While queued, `automatic_attempts_left: false` (and `poll_again_in_seconds: null`) means the automatic runs are finished and further polling will not change the answer. When the request has a pot, the response adds bounty_id, pot_status, pot and subscribe_url, and pledge_url once the pot takes money. While pot_status is needs_fixtures it takes no money yet: pot_waiting says who adds the example answers and what happens next, pot_contract_url is there only when this caller can add them without paying (the key that created the request), and pot_open_url is there when anyone can open it: POST it with amount_usd and contract, and the pot opens with that contract when the payment goes through.

## Path parameters

- `id` string, required

## Response `200`

The request state.

## Other responses

- `404`: No such request.

---

[API](https://skmtc.dev/licium/apis/licium-public-api.md) · [All operations](https://skmtc.dev/licium/apis/licium-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/licium/apis/licium-public-api/revisions/d91a72f755f4?raw)