> ## Documentation Index
> Fetch the complete documentation index at: https://www.smartretry.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Future transaction status

> Retrieve the details and current status of a single scheduled future payment within a recurring series.

`GET /v1/payments/recurring/future-transactions/status/{terminal_friendly_id}`

Returns the details of a specific future transaction - its scheduled date, amount, currency, and current processing status. Use this endpoint to check the state of an individual upcoming payment within a recurring series.

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://terminal.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123' \
    --header 'x-api-key: YOUR_API_KEY'
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://terminal.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123",
      headers={"x-api-key": "YOUR_API_KEY"}
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://terminal.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123",
    {
      method: "GET",
      headers: {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

## Path parameters

<ParamField path="terminal_friendly_id" type="string" required>
  Your 6-character terminal identifier.
</ParamField>

## Response

<ResponseField name="future_transaction_id" type="string">
  Unique identifier of this future transaction (8 characters).
</ResponseField>

<ResponseField name="recurring_id" type="string">
  Identifier of the recurring series this transaction belongs to (8 characters).
</ResponseField>

<ResponseField name="scheduled_date" type="string">
  The date this payment is scheduled to be processed, in `YYYY-MM-DD` format.
</ResponseField>

<ResponseField name="sequence_number" type="integer">
  The position of this payment within the series (e.g., `2` means it is the second payment in the schedule).
</ResponseField>

<ResponseField name="amount" type="number">
  Amount to be charged in major currency units (e.g., `19.99`).
</ResponseField>

<ResponseField name="currency" type="string">
  ISO 4217 currency code for this payment.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of this future transaction. One of:

  * `pending` - scheduled and waiting to be processed.
  * `processing` - currently being executed.
  * `completed` - successfully processed.
  * `failed` - processing attempted but unsuccessful.
  * `cancelled` - this specific occurrence was cancelled.
</ResponseField>

<ResponseField name="executed_transaction" type="string">
  The `transaction_id` of the transaction that executed this future payment. Present only when `status` is `completed`.
</ResponseField>

<ResponseField name="executed_at" type="string">
  ISO 8601 timestamp of when this future transaction was executed. Present only when `status` is `completed`.
</ResponseField>

<ResponseField name="notes" type="string">
  Optional notes associated with this future transaction.
</ResponseField>

```json Example response theme={null}
{
  "future_transaction_id": "FT3D8E1C",
  "recurring_id": "RC9F4A2B",
  "scheduled_date": "2026-05-01",
  "sequence_number": 2,
  "amount": 19.99,
  "currency": "USD",
  "status": "pending"
}
```

<Tip>
  To see all upcoming payments for a series at once, use the [recurring status endpoint](/docs/api-reference/recurring/status) - it includes the full `future_transactions` array in a single response.
</Tip>