# Confirmation

`GET https://api.tentary.com/v1/confirmations/{confirmation_id}`

Source: https://tentary.com/en/help/api/get-confirmation/
Area: Delete and confirmations
MCP tool: `get_confirmation`. Reads only. Changes nothing in the account.

---

The state of an action that needs the confirmation of the account owner, for example from [`POST /v1/email/campaigns/{campaign_id}/send`](https://tentary.com/en/help/api/send-email-campaign/), [`POST /v1/orders/{order_id}/refund`](https://tentary.com/en/help/api/refund-order/) or [`POST /v1/delete`](https://tentary.com/en/help/api/delete-item/).

- `pending`: not decided yet.
- `running`: confirmed, and the action runs now. Ask again in a few seconds.
- `done`: it ran. `result` has the details.
- `failed`: it could not run. `result` says why.
- `canceled`: the account owner said no.
- `expired`: the link expired.

## Authorization

`Authorization: Bearer <API key>`

A personal API key (tnt_...). Create it in the Tentary app on the page AI & API.

## Path parameters

- `confirmation_id` (integer, required, path): The confirmation_id from the tool that asked. Limits: min 1.

## Response

- `id` (integer): The ID.
- `action` (string): The tool that asked, like refund_order or delete_product.
- `target_id` (integer): The ID of the thing.
- `summary` (string): Short summary.
- `status` (string): pending = not decided yet. running = confirmed, the action runs now. done = it ran. failed = it could not run. canceled = the seller said no. Allowed values: `pending`, `running`, `done`, `failed`, `canceled`, `expired`.
- `result` (object, can be null): done: the details of the action, like order_id and refunded, or campaign_id, send_at and estimated_recipients. failed and canceled: message (and error). null while pending or running.
- `created_at` (string<date-time>, can be null): UTC, like 2026-01-31T14:05:00Z.
- `expires_at` (string<date-time>, can be null): UTC, like 2026-01-31T14:05:00Z.
- `decided_at` (string<date-time>, can be null): UTC, like 2026-01-31T14:05:00Z.

## Example request

```bash
curl "https://api.tentary.com/v1/confirmations/7" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "id": 7,
  "action": "refund_order",
  "target_id": 1003,
  "summary": "Refund order R5D7H2B8 (31.20 EUR)",
  "status": "done",
  "result": {
    "order_id": 1003,
    "refunded": "31.20",
    "currency": "EUR"
  },
  "created_at": "2026-10-27T08:51:48Z",
  "expires_at": "2026-10-27T08:56:48Z",
  "decided_at": "2026-10-27T08:51:48Z"
}
```