---
title: "Get sender configuration"
method: GET
path: "/lists/{listId}/sender"
tags: ["Sender"]
---

# Get sender configuration

`GET /lists/{listId}/sender`

## Request

- Base URL: `https://api.tinysend.com/v1`
- URL: `https://api.tinysend.com/v1/lists/{listId}/sender`
- Auth: HTTP bearer

Who emails are sent from: tinysend default, your own domain, or gmail (coming soon). Includes DNS records with found/not-found status and a plain-language next step.

## Path parameters

- `listId` string, required

## Response `200`

Sender info

- SenderInfo
  - `type` string, required
  - `from_address` string, required
  - `status` 'default' | 'pending' | 'verified' | 'failed', required
  - `records` DnsRecordView[], required
    - `type` string, required
    - `name` string, required
    - `value` string, required
    - `found` boolean, required: whether we can see this record in DNS yet
    - `purpose` string: plain-words explanation of what the record does
  - `next_step` string, required

## Other responses

- `404`: Not found

---

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