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

# Pagination

> Which lists page, with what parameters, and which return everything at once.

> Agents: the full documentation index is at [/llms.txt](https://docs.revcenter.ai/llms.txt).

Only `GET /v1/searches/{searchId}/people` pages. It uses an offset:

| Parameter | Default | Allowed |
| - | - | - |
| `limit` | 100 | 1 to 500; values outside are clamped |
| `offset` | 0 | 0 or more |
| `min_score` | none | Only people scoring at least this |
| `profile` | `true` | `false` leaves out the full profile |

The response has `people` (best score first) and `total`, the number of people matching `min_score`:

```json theme={null}
{ "data": { "people": [ { "id": "…", "name": "Dana Whitfield", "score": 91 } ], "total": 2 }, "meta": { "request_id": "…" } }
```

Read the next page with `offset` + `limit` until you have `total` people. A page past the end returns
`people: []` and `total: 0`, so stop on an empty page rather than comparing `total`.

```bash theme={null}
revcenter people <search_id> --min-score 80 --limit 100
```

The CLI passes `--limit`; to read a later page, call the API with `offset`.

## Lists that don't page

| List | Returns |
| - | - |
| `GET /v1/projects` | The 200 most recently created projects |
| `GET /v1/projects/{id}/searches` | Every search in the project, oldest first |
| `GET /v1/projects/{id}/shortlist` · `shortlist.csv` | The whole shortlist |
| `GET /v1/reference/industries` | Up to 200 matches |
| `POST …/shortlist/members` | Takes up to 200 `candidate_ids` per call |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.