GET
/
mailing-lists
/
List All
const url = 'https://api.thanks.io/api/v2/mailing-lists/';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}, body: undefined};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
{
  "data": [
    {
      "id": 3019,
      "user_id": 2,
      "sub_account_id": null,
      "type": "manual",
      "description": "Test Mailing List",
      "qrcode_url": null,
      "total_recipients": 0,
      "processed": true,
      "is_suppression_list": false,
      "total_scans": 0,
      "unique_scans": 0,
      "last_scan": null,
      "total_sends": 0,
      "last_send": null,
      "api_key": "TEST-KEY1",
      "created_at": "2025-08-06T01:06:52.000000Z",
      "created_at_diff": "13 hours ago",
      "updated_at": "2025-08-06T01:06:52.000000Z"
    },
    {
      "id": 3017,
      "user_id": 2,
      "sub_account_id": null,
      "type": "csv",
      "description": "Mailing List (Csv) Created 07/16/2025",
      "qrcode_url": null,
      "total_recipients": 0,
      "processed": false,
      "is_suppression_list": false,
      "total_scans": 0,
      "unique_scans": 0,
      "last_scan": null,
      "total_sends": 0,
      "last_send": null,
      "api_key": "TEST-KEY2",
      "created_at": "2025-07-16T19:00:31.000000Z",
      "created_at_diff": "2 weeks ago",
      "updated_at": "2025-07-16T19:00:31.000000Z"
    }
  ],
  "links": {
    "first": "https://api.thanks.io/api/v2/mailing-lists?page=1",
    "last": "https://api.thanks.io/api/v2/mailing-lists?page=377",
    "prev": null,
    "next": "https://api.thanks.io/api/v2/mailing-lists?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 377,
    "path": "https://api.thanks.io/api/v2/mailing-lists",
    "per_page": "2",
    "to": 2,
    "total": 754
  }
}

Authorizations

Authorization
string
header
required

Bearer token authentication using your thanks.io API key

Query Parameters

items_per_page
integer
default:25

Number of items to return per page.

Response

200
application/json

OK

The response is of type object.