---
title: "Read a purchased list and its rows"
method: GET
path: "/v1/agent/lists/{purchase_id}"
---

# Read a purchased list and its rows

`GET /v1/agent/lists/{purchase_id}`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/agent/lists/{purchase_id}`
- Auth: API key in header `Authorization`

## Path parameters

- `purchase_id` string, required

## Response `200`

Where the run stands, and the rows once it ends

- object
  - `purchase_id` string, required
  - `status` string, required: running while it works; completed, partial, failed, canceled or expired when it ends.
  - `request` string
  - `reading` object
  - `requested` integer
  - `found` integer
  - `currency` string
  - `paid` string
  - `authorized` string
  - `charged` string
  - `refunded` string
  - `payment` object
  - `note` string
  - `rows` object[]: The matches, each with its source. Present when the run has ended.

## Other responses

- `404`: No purchase for this id and token
- `default`: Error envelope

---

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