API reference Mandates
Check a cart against a mandate
POST/v1/mandates/{id}/check
A dry run: what a countersign of this cart would find, field by field, from the same policy set the TEE legs run, with nothing signed, reserved or logged. The countersign stays the only decision. An app acting for a user (purchases:write) checks only under a mandate that user approved for it.
Path parameters
idstringRequired
Headers
Content-Typeapplication/jsonRequiredIdempotency-KeystringRequired- 1 to 255 characters. A retry with the same key returns the first answer.
Request body
application/json
cartobjectRequired
Responses
- 200The check
- 401No valid access token
- 404No such mandate of an operator this client linked
200 response
canAttemptbooleanRequired- Whether a countersign of this cart would pass the mandate as it stands now.
needsApprovalbooleanRequired- The cart passes, and is above the user's ask-me amount: the countersign pauses it for their one-time approval.
blockersarray of objectRequiredchecksarray of objectRequired