# Your lists, newest first

`GET /api/v1/lists`

All lists of your account (uploads, API jobs and business searches), newest first.

**Credits:** Free.

## Parameters

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `limit` | integer | yes | Rows per page, 1–1000. default `100`, 1–1000 |
| `cursor` | string |  | The `nextCursor` of the page before. Leave out for the first page. |

## Example request

```bash
curl "https://moleman.io/api/v1/lists" \
  -H "Authorization: Bearer $MOLEMAN_API_KEY"
```

## Errors

| Status | Code | When |
| --- | --- | --- |
| 401 | [`missing_api_key`](/docs/errors#missing_api_key) | The request has no API key. |
| 401 | [`invalid_api_key`](/docs/errors#invalid_api_key) | The API key is not one of ours (a typo, a cut-off copy, or a key from another account that was deleted). |
| 401 | [`revoked_api_key`](/docs/errors#revoked_api_key) | The API key was revoked on the API page. Revoking takes effect at once. |
| 429 | [`rate_limited`](/docs/errors#rate_limited) | More than 120 requests in one minute with this key. |
| 500 | [`server_error`](/docs/errors#server_error) | Something broke on our side. Nothing was charged for it. |
| 400 | [`invalid_request`](/docs/errors#invalid_request) | A parameter is missing, has the wrong type or is out of range. `details` lists every problem with its path. |
| 400 | [`invalid_cursor`](/docs/errors#invalid_cursor) | The cursor is not one we gave out (they are opaque; do not build them yourself). |