Notify API reference

Notify API · Client

get/v1/client/approvals/{approval_id}Auth

Get an approval request

One request the recipient was asked to answer: the question, who asked, its status and, once decided, who answered and why.

Path parameters

approval_id*string · uuid

Id of the approval.

Response · 200 The request.

id*string · uuid

The approval request id.

type*string

The notification type key.

Example: "deploy.approval"

status*object

`pending` until someone answers; then `approved` or `rejected`; `expired` (or the type's timeout outcome) when nobody answered in time; `cancelled` when the requester withdrew it.

title*string

The question.

body*string

The details.

requester*object

Who asked.

approvers*array

Approver external ids (null entries for erased recipients are dropped).

metadata*object

Your metadata, as sent.

expires_at*string · date-time

When it times out.

decided_by*string

Who answered (external id); null while pending, on timeout or cancel.

reason*string

The approver's reason, if they gave one.

decided_via*object

Where the answer came from: `inbox` (in-app buttons or `<NotifyApproval/>`), `hosted_page` (the link in an email or push), `api` (your backend), `timeout`.

decided_at*string · date-time

When it was answered, expired or cancelled.

notification_id*string · uuid

The notification that carried it (see the message log for every channel's delivery).

created_at*string · date-time

Created.

Example

Request

GET https://api.notify.productcraft.co/v1/client/approvals/{approval_id}
Authorization: Bearer YOUR_TOKEN

Response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "type": "deploy.approval",
  "status": {},
  "title": "string",
  "body": "string",
  "requester": {},
  "approvers": [
    "string"
  ],
  "metadata": {},
  "expires_at": "2026-01-01T00:00:00.000Z",
  "decided_by": "string",
  "reason": "string",
  "decided_via": {},
  "decided_at": "2026-01-01T00:00:00.000Z",
  "notification_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-01-01T00:00:00.000Z"
}