Skip to main content
POST
https://api.plane.com/v1
/
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
}