---
title: "Get Details"
method: GET
path: "/mailing-lists/{mailingListId}"
tags: ["Mailing Lists"]
---

# Get Details

`GET /mailing-lists/{mailingListId}`

## Request

- Base URL: `https://api.thanks.io/api/v2`
- URL: `https://api.thanks.io/api/v2/mailing-lists/{mailingListId}`
- Auth: HTTP bearer

Gets a mailing list by ID. Returns a single mailing list object.

## Response `200`

Successful Response

- MailingList
  - `id` integer
  - `user_id` integer
  - `sub_account_id` integer, nullable
  - `type` 'csv' | 'manual' | 'map' | 'friends' | 'retarget' | 'leads' | 'zapier' | 'radius' | 'highlevel' | 'qrscans'
  - `description` string
  - `qrcode_url` string, nullable
  - `total_recipients` integer
  - `processed` boolean
  - `is_suppression_list` boolean
  - `total_scans` integer
  - `unique_scans` integer
  - `last_scan` string, nullable
  - `total_sends` integer
  - `last_send` string, nullable
  - `api_key` string: API key that can be used to add recipients to this mailing list with thanks.io Webhooks
  - `created_at` string, date-time
  - `created_at_diff` string: Human-friendly relative time since creation
  - `updated_at` string, date-time

## Other responses

- `403`: Access token is missing or invalid
- `404`: Resource not found

---

[API](https://skmtc.dev/thanks-io/apis/thanks-io-api.md) · [All operations](https://skmtc.dev/thanks-io/apis/thanks-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thanks-io/apis/thanks-io-api/revisions/c403fbf3dc0f?raw)