Reference · Lists
Rows as JSON pages or one CSV file
GET /api/v1/lists/{id}/rows
The rows of a list. format=json (default): pages of limit rows with nextCursor. format=csv: the whole list as one CSV file with plain column names (email, first_name, last_name, company_name, website, personalization …) that Instantly, Smartlead and most CRMs map without help. only=works keeps only emails that Work.
Credits: Free.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | yes | The id. |
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. | |
format | "json" · "csv" | yes | csv: the whole list as one CSV file (no paging), ready for Instantly, Smartlead or a CRM. default "json" |
only | "all" · "works" | yes | works: only rows whose email Works. default "all" |
Example request
curl "https://moleman.io/api/v1/lists/123/rows" \
-H "Authorization: Bearer $MOLEMAN_API_KEY"Errors
| Status | Code | When |
|---|---|---|
| 401 | missing_api_key | The request has no API key. |
| 401 | 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 | The API key was revoked on the API page. Revoking takes effect at once. |
| 429 | rate_limited | More than 120 requests in one minute with this key. |
| 500 | server_error | Something broke on our side. Nothing was charged for it. |
| 400 | 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 | The cursor is not one we gave out (they are opaque; do not build them yourself). |
| 404 | not_found | The job or list does not exist, belongs to another account, or was deleted. |
| 403 | wrong_key_mode | A test key asked for something made with a live key, or the other way round. Test and live data never mix. |