POST
/
payment-requests
/
{id}
/
approve
Approve a payment request
curl --request POST \
  --url https://api.plane.com/v1/payment-requests/{id}/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "approver": "<string>",
  "reason": "<string>"
}'
{
  "id": "ptr_ogdEjSnSqNYxtW1sd3pC3hFX",
  "worker": "wr_anqRSFcK36ie85",
  "amount": "1200.00",
  "currency": "EUR",
  "status": "approved",
  "reference": "EV1S3GDM",
  "note": "Payment for July",
  "period": {
    "starts": "2023-07-01",
    "ends": "2023-07-31"
  },
  "documents": [],
  "approvals": ["apr_YzmQ5oxQE78bDV3fZwEU3vGr"],
  "payment": null
}

A request can be approved any number of times by any number of individuals in your Plane account.

Each approval will be independently listed on the Payment Request object.

​
Parameters

​
id
string
required

The ID of the payment request you are approving.

​
approver
string
required

The ID of the person approving this request.

​
reason
string

An optional description of why the request was approved, visible to the worker.

​
Returns

Returns the Payment Request object with a new approval.

{
  "id": "ptr_ogdEjSnSqNYxtW1sd3pC3hFX",
  "worker": "wr_anqRSFcK36ie85",
  "amount": "1200.00",
  "currency": "EUR",
  "status": "approved",
  "reference": "EV1S3GDM",
  "note": "Payment for July",
  "period": {
    "starts": "2023-07-01",
    "ends": "2023-07-31"
  },
  "documents": [],
  "approvals": ["apr_YzmQ5oxQE78bDV3fZwEU3vGr"],
  "payment": null
}