Get a list with entries

GEThttps://myagentmail.com/v1/inboxes/{id}/lists/{lid}

Path parameters

`id` required string	Inbox UUID
`lid` required string	List UUID

Responses

200application/jsonOK

`id` string	format: uuid
`name` string
`description` string
`entryCount` integer
`entries` object[]
`id` string	format: uuid
`email` string	format: email
`displayName` string
`metadata` object
`createdAt` string	format: date-time
`createdAt` string	format: date-time

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/inboxes/{id}/lists/{lid}
const result = await client.request("get", "/v1/inboxes/{id}/lists/{lid}", { params: { id: "00000000-0000-0000-0000-000000000000", lid: "00000000-0000-0000-0000-000000000000" } });

Example response · 200

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "string",
  "description": "string",
  "entryCount": 0,
  "entries": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "email": "[email protected]",
      "displayName": "string",
      "metadata": {},
      "createdAt": "2026-05-01T08:11:44.803Z"
    }
  ],
  "createdAt": "2026-05-01T08:11:44.803Z"
}