Get an approval

curl --request GET \
  --url https://api.panoflow.io/v1/approvals/{approval_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/approvals/{approval_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "apr_01JCRJFJ2XBAHW0GQNMF2KDPB0",
  "object": "approval",
  "kind": "agent_payment",
  "subject_id": "trf_01JC9EE0ZBGJ09TQM83XSSSS6Y",
  "subject_object": "transfer",
  "summary": "Pay ₦184,500.00 to LEKKI OFFICE SUPPLIES LTD",
  "amount": {
    "amount": 18450000,
    "currency": "NGN"
  },
  "status": "pending",
  "reason": "Restocking printer paper, toner and dispatch labels for the Wuse depot. Quote LOS-2291 matches last month's order.",
  "triggers": [
    {
      "code": "new_recipient",
      "message": "New recipient"
    },
    {
      "code": "over_ask_first_amount",
      "message": "Over ₦150,000"
    }
  ],
  "payee": {
    "account_number": "3011204120",
    "bank_code": "011",
    "bank_name": "First Bank",
    "account_name": "LEKKI OFFICE SUPPLIES LTD"
  },
  "source_account": {
    "id": "acc_01JCB9Y73MY63FCH26W14WMCHW",
    "name": "Naira · Procurement agent",
    "currency": "NGN",
    "account_number_last4": "2375"
  },
  "agent_id": "agt_01JCY1JX4WHRDD459GQ8H7QEZZ",
  "agent_client": "Claude",
  "requested_by": {
    "type": "agent",
    "id": "agt_01JCY1JX4WHRDD459GQ8H7QEZZ",
    "name": "Procurement agent"
  },
  "requested_at": "2026-10-28T08:54:00Z",
  "expires_at": "2026-10-29T08:54:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

GET

approvals

{approval_id}

Get an approval

curl --request GET \
  --url https://api.panoflow.io/v1/approvals/{approval_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/approvals/{approval_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "apr_01JCRJFJ2XBAHW0GQNMF2KDPB0",
  "object": "approval",
  "kind": "agent_payment",
  "subject_id": "trf_01JC9EE0ZBGJ09TQM83XSSSS6Y",
  "subject_object": "transfer",
  "summary": "Pay ₦184,500.00 to LEKKI OFFICE SUPPLIES LTD",
  "amount": {
    "amount": 18450000,
    "currency": "NGN"
  },
  "status": "pending",
  "reason": "Restocking printer paper, toner and dispatch labels for the Wuse depot. Quote LOS-2291 matches last month's order.",
  "triggers": [
    {
      "code": "new_recipient",
      "message": "New recipient"
    },
    {
      "code": "over_ask_first_amount",
      "message": "Over ₦150,000"
    }
  ],
  "payee": {
    "account_number": "3011204120",
    "bank_code": "011",
    "bank_name": "First Bank",
    "account_name": "LEKKI OFFICE SUPPLIES LTD"
  },
  "source_account": {
    "id": "acc_01JCB9Y73MY63FCH26W14WMCHW",
    "name": "Naira · Procurement agent",
    "currency": "NGN",
    "account_number_last4": "2375"
  },
  "agent_id": "agt_01JCY1JX4WHRDD459GQ8H7QEZZ",
  "agent_client": "Claude",
  "requested_by": {
    "type": "agent",
    "id": "agt_01JCY1JX4WHRDD459GQ8H7QEZZ",
    "name": "Procurement agent"
  },
  "requested_at": "2026-10-28T08:54:00Z",
  "expires_at": "2026-10-29T08:54:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Server API key, scoped. pk_test_ keys hit the sandbox tenant.

Headers

X-Request-Id

string

Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always our own req_… id. We log your value with the request as client_request_id, so support can find a request by either id. A longer value is refused with 400 parameter_invalid.

Maximum string length: 128

Path Parameters

approval_id

string

required

apr_…

Pattern: ^apr_[0-9A-HJKMNP-TV-Z]{26}$

Response

The approval.

The shared Approval (CONVENTIONS §9) plus what the customer approval screens show. Generic over every customer ApprovalKind; payment-specific fields are present only for payment kinds.

string

required

apr_…

object

string

required

Allowed value: "approval"

kind

enum<string>

required

What an approval is for. Customers see transfer, batch, pay_run, agent_payment, member_role_change and limit_change; the other kinds are PanoFlow's own and never returned to customers.

Available options:

transfer,

batch,

pay_run,

agent_payment,

member_role_change,

limit_change,

business_approval,

business_freeze,

business_unfreeze,

payment_reversal,

ledger_adjustment,

recon_resolution,

fee_refund,

staff_role_change,

staff_super_admin,

str_filing,

pricing_change,

risk_rule_change,

feature_flag_change,

partner_secret_rotation

subject_id

string

required

Id of the thing being approved.

status

enum<string>

required

Approval state.

Available options:

pending,

approved,

rejected,

expired,

canceled

requested_by

object

required

Who did something. Shown in activity, approvals and the audit log.

Show child attributes

requested_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

summary

string

One-line human summary, e.g. "Pay ₦850,000.00 to NGOZI ADEYEMI".

amount

object

An amount in minor units (kobo, cents) with its currency. Never a decimal.

Show child attributes

reason

string

Why the requester asked.

decision_note

string

Note from the person who decided.

decided_by

object

Who did something. Shown in activity, approvals and the audit log.

Show child attributes

decided_at

string<date-time>

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

expires_at

string<date-time>

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

subject_object

string

Object type of subject_id, e.g. transfer, batch, pay_run, membership.

triggers

object[]

Why it needs approval.

Show child attributes

payee

object

For transfer and agent_payment, the account being paid ("••••4120 · First Bank · name confirmed").

Show child attributes

source_account

object

Enough of a PanoFlow account to show it ("Naira · Main · ••••6789"). Full account in the Accounts API.

Show child attributes

agent_id

string

For agent_payment, the agent (agt_…).

agent_client

string

For agent_payment, the MCP client the agent used ("through Claude").

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

Get an approval

Authorizations

Headers

Path Parameters

Response