---
title: "List Attempted Destinations"
method: GET
path: "/api/v1/app/{app_id}/msg/{msg_id}/endpoint"
tags: ["Message Attempt"]
---

# List Attempted Destinations

`GET /api/v1/app/{app_id}/msg/{msg_id}/endpoint`

List endpoints attempted by a given message.

Additionally includes metadata about the latest message attempt.
By default, endpoints are listed in ascending order by ID.

## Path parameters

- `app_id` string, required — The Application's ID or UID.
- `msg_id` string, required — The Message's ID or UID.

## Query parameters

- `limit` integer — Limit the number of returned items
- `iterator` string, nullable — The iterator returned from a prior invocation

## Response `200`

- ListResponseMessageEndpointOut
  - `data` MessageEndpointOut[], required
    - `channels` string[], nullable — List of message channels this endpoint listens to (omit for all).
    - `createdAt` string, date-time, required
    - `description` string, required
    - `disabled` boolean
    - `eventTypes` string[], nullable
    - `id` string, required — The Endpoint's ID.
    - `nextAttempt` string, date-time, nullable
    - `status` 0 | 1 | 2 | 3 | 4, required — The sending status of the message: - Success = 0 - Pending = 1 - Fail = 2 - Sending = 3 - Canceled = 4
    - `statusText` 'success' | 'pending' | 'fail' | 'sending' | 'canceled', required
    - `throttleRate` integer, nullable — Maximum messages per second to send to this endpoint. Outgoing messages will be throttled to this rate.
    - `uid` string, nullable — Optional unique identifier for the endpoint.
    - `updatedAt` string, date-time, required
    - `url` string, uri, required
  - `done` boolean, required
  - `iterator` string, nullable, required
  - `prevIterator` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

## Changes

- **2026-08-19** `dc130bd1b074` — 1 breaking, 2 warning, 1 info
  - removed the required property `data/items/version` from the response with the `200` status
  - removed the optional property `data/items/filterTypes` from the response with the `200` status
  - removed the optional property `data/items/rateLimit` from the response with the `200` status
  - added the optional property `data/items/eventTypes` to the response with the `200` status
- **2026-07-31** `16dbcc056c48` — 1 info
  - added the required property `data/items/version` to the response with the `200` status

[Change history](https://skmtc.dev/svix/apis/svix-api/changes/api/v1/app/:app_id/msg/:msg_id/endpoint/get.md)

---

[API](https://skmtc.dev/svix/apis/svix-api.md) · [All operations](https://skmtc.dev/svix/apis/svix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/svix/svix-api/revisions/50dde67d2d2d/schema)
