One approval, with its decisions
The request and every answer recorded against it so far. A pending request with no decisions is normal — it means nobody has looked yet, which is different from somebody having declined.
The request and every answer recorded against it so far.
A pending request with no decisions is normal — it means nobody has looked yet, which is different from somebody having declined.
Authorization
OAuth2PasswordBearer In: header
Path Parameters
uuidCookie Parameters
Response Body
application/json
application/json
curl -X GET "https://example.com/api/b/v1/approvals/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "approval": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "subject_type": "payout", "subject_id": "80e197be-61ad-4068-b4ff-a483fb5c18f9", "amount_minor": 0, "currency": "string", "status": "pending", "required_approvals": 0, "current_level": 1, "levels": [ {} ], "approvals_recorded": 0, "initiated_by": "9f5ebe27-153d-4963-8417-06d50be356ec", "initiated_by_name": "string", "created_at": "2019-08-24T14:15:22Z", "decided_at": "2019-08-24T14:15:22Z" }, "decisions": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "decision": "approve", "decided_by": "4accc021-c0cc-4c2c-8a78-605a0ed6da31", "decided_by_name": "string", "note": "string", "decided_at": "2019-08-24T14:15:22Z" } ]}Movements awaiting a signature GET
Everything waiting on a decision, newest first. Defaults to `pending` because that is the working queue; the decided ones are an archive somebody goes looking for, and defaulting to all of them would bury today's three payouts under last quarter's four hundred.
Sign off on a movement POST
Record one approval; the request completes when enough have agreed. Approving does not move the money. `assert_executable` is a separate call made immediately before the movement runs, because between the last signature and that moment the funds can have left by another route. 409 when the request is already decided, and 403 when the caller raised it: the person who initiated a movement may not approve their own.