> ## Documentation Index
> Fetch the complete documentation index at: https://docs.freshtalent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List saved queries

> Return every saved people-search query for the authenticated organization.

Returns the organization's saved search records, newest first. Saved queries are organization-scoped; the API key cannot read another organization's records.

This endpoint has no query parameters and is **not paginated**. It returns every saved query in `data`, with `meta.count` equal to the array length. There is no cursor, `limit`, `offset`, or `meta.next`.

## Response schema

Each item in `data` has:

| Field        | Type                        | Nullability and meaning                                                                                       |
| ------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `id`         | string (UUID)               | Never null.                                                                                                   |
| `name`       | string                      | Never null.                                                                                                   |
| `query`      | object                      | Never null. Contains the compacted echoed people-search fields that were accepted when saved. It can be `{}`. |
| `created_at` | string (ISO 8601 timestamp) | Never null.                                                                                                   |

The nested `query` keys and their types are documented on [Save query](/api-reference/queries/save). `null` and empty-string values are omitted when a query is saved; missing keys are not returned as `null` placeholders.

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Palantir FDE leavers",
        "query": {
          "company": "palantir",
          "role_family": "forward-deployed-engineer",
          "company_left_min_months_ago": 18,
          "open_to_work": true
        },
        "created_at": "2026-09-07T10:00:00.000Z"
      }
    ],
    "meta": {
      "count": 1
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --fail-with-body --max-time 30 "https://api.freshtalent.ai/v1/queries" \
    -H "Authorization: Bearer $FRESHTALENT_API_KEY"
  ```

  ```js JavaScript (native fetch) theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const response = await fetch("https://api.freshtalent.ai/v1/queries", {
    signal: AbortSignal.timeout(30_000), headers: { Authorization: `Bearer ${process.env.FRESHTALENT_API_KEY}` },
  });
  if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
  const body = await response.json();
  for (const saved of body.data) console.log(saved.id, saved.name, saved.query);
  ```

  ```python Python (stdlib) theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import json
  import os
  from urllib.request import Request, urlopen

  request = Request(
      "https://api.freshtalent.ai/v1/queries",
      headers={"Authorization": f"Bearer {os.environ['FRESHTALENT_API_KEY']}"},
  )
  with urlopen(request, timeout=30) as response:
      body = json.load(response)
  for saved in body["data"]:
      print(saved["id"], saved["name"], saved["query"])
  ```
</RequestExample>

## Errors and recovery

* `400` (`invalid_request`): when using the platform API key, provide a valid `X-FreshTalent-Org-Id` UUID.
* `401` (`unauthorized`): provide a valid API key.
* `402` (`payment_required`): restore the organization's entitlement.
* `429` or `5xx`: retry with backoff. The read is safe to repeat.

## Related

| Method   | Path           | Purpose                                       |
| -------- | -------------- | --------------------------------------------- |
| `POST`   | `/queries`     | [Save query](/api-reference/queries/save)     |
| `GET`    | `/queries/:id` | [Get saved query](/api-reference/queries/get) |
| `DELETE` | `/queries/:id` | Delete a saved query; returns `204`.          |

**Next:** [Save query](/api-reference/queries/save) or [Get saved query](/api-reference/queries/get).