---
title: "List this account's pending sends, newest first"
method: GET
path: "/v2/pending-sends"
tags: ["pending-sends-v2"]
---

# List this account's pending sends, newest first

`GET /v2/pending-sends`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/pending-sends`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `limit` string
- `cursor` string
- `before` string
- `status` string

## Response `200`

Success

- PendingSendListResponse
  - `has_more` boolean: True when older rows exist beyond this page; pass next_cursor as cursor
  - `next_cursor` string, nullable: Opaque continuation cursor; null on the final page
  - `pending_sends` PendingSendRow[]
    - `api_key_id` string: ID of the key that submitted it
    - `created_at` string: ISO8601 UTC
    - `decided_at` string, nullable: When it was approved, rejected, or cancelled (ISO8601 UTC)
    - `decided_by` string, nullable: user:<id> for a dashboard decision, api_key:<id> for a cancel
    - `decision_reason` string, nullable: Rejection reason given by the approver
    - `executed_at` string, nullable: When the approved payload was sent (ISO8601 UTC)
    - `executed_by_key_id` string, nullable: ID of the key that executed it
    - `execution` object, nullable: Durable publication evidence; uncertain outcomes must be reconciled
    - `expires_at` string: When an undecided or unexecuted send lapses (ISO8601 UTC); 24 hours after creation
    - `id` string: Pending send ID
    - `kind` string: send | send_bulk
    - `last_error` object, nullable: The send error body from the most recent failed execute attempt; null otherwise
    - `note` string, nullable: The note as submitted
    - `recipient_count` integer: Messages in the held payload
    - `result` object, nullable: The send response body once executed; null before
    - `sandbox` boolean: True when held by a sandbox key; only a key in the same mode can execute it
    - `status` string: pending | approved | executing | unknown_execution | sent | rejected | cancelled | expired

## Other responses

- `400`: Invalid parameter
- `401`: Authentication error
- `503`: Pending-send authority unavailable

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)