---
name: "notify_get_approval"
area: "notify"
title: "Check an approval"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/notify_get_approval"
mcp_server: "https://api.conecto.chat/mcp/notify"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/notify/notify_get_approval"
---

# Check an approval (`notify_get_approval`)

Where a question asked with notify_request_approval stands, with the answer and comment once it has one.

Where a question you asked with notify_request_approval stands: waiting, answered (with the answer and the comment), expired or cancelled. The answer also comes as the event notify.answered.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Waiting for a decision, when no webhook receives notify.answered.

## Say this to your agent

> Did I say yes to that refund?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `request_id` | string | yes | Exactly 36 characters. |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `notify_get_approval` on the MCP server `https://api.conecto.chat/mcp/notify` with these arguments:

```json
{
  "request_id": "7c1e9a42-5b3d-4f8e-a6c2-0d9e8f7a6b5c"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/notify_get_approval \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id": "7c1e9a42-5b3d-4f8e-a6c2-0d9e8f7a6b5c"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "notify_get_approval",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "request": {
      "request_id": "7c1e9a42-5b3d-4f8e-a6c2-0d9e8f7a6b5c",
      "question": "Refund order 1042 in full ($849)?",
      "details": "The buyer says the Tabor arrived with a bent derailleur hanger and sent two photos.",
      "options": [
        "Approve",
        "Decline"
      ],
      "status": "waiting",
      "answer": null,
      "comment": null,
      "answered_at": null,
      "reference": "order-1042",
      "sent_to": "dana@halversoncycle.example",
      "via": "email",
      "expires_at": "2026-10-17T08:00:00+00:00",
      "created_at": "2026-10-14T08:00:00+00:00"
    }
  }
}
```

`result`: request: its question, options, status (waiting, answered, expired or cancelled), the answer, the comment and when it was answered.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No approval request has that id. | Use the request_id the request returned. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [notify_add_channel](https://conecto.chat/tools/notify/notify_add_channel.md): Saves a place to send messages by name: Slack, Teams, Discord or Google Chat, a Telegram chat, ntfy, Pushover, or the business's own webhook. $0.001 a call.
- [notify_list_channels](https://conecto.chat/tools/notify/notify_list_channels.md): The saved channels: where each goes (never its token), the events it gets, and whether the last message arrived. Free up to 1,000,000 reads a month.
- [notify_send](https://conecto.chat/tools/notify/notify_send.md): Sends a message to one or more saved channels, with a title, a link or high priority; only the channels it reached are charged. $0.005 per channel reached.
- [notify_request_approval](https://conecto.chat/tools/notify/notify_request_approval.md): Asks a person to approve or decline (or pick an option) before the agent acts, on a one-time page sent through a channel or by email. $0.01 a request, $0.02 more by email, up to $0.03.
- [notify_list_events](https://conecto.chat/tools/notify/notify_list_events.md): Every event a channel can get on its own: a job application, a booking, a form response, a signed document, a site going down and more. Free up to 1,000,000 reads a month.
- [notify_subscribe](https://conecto.chat/tools/notify/notify_subscribe.md): Sends chosen events to a saved channel as they happen, replacing the channel's list. $0.001 a call.
- [notify_unsubscribe](https://conecto.chat/tools/notify/notify_unsubscribe.md): Stops every event to a channel; the channel stays for notify_send. Free.
- [notify_remove_channel](https://conecto.chat/tools/notify/notify_remove_channel.md): Deletes a saved channel, with the events it got. Free.