API reference
Procurement API
Endpoints behind the software-procurement module: requests, document upload, online-terms capture, legal review, verification, gates and the decision.
Tenant-scoped and role-gated
All endpoints operate within the caller’s tenant. Verifying a review and making a decision require the Verifier role. See Authentication.
Requests
POST/api/procurement/requestsCreate a request. Returns its request_id; a warning is set when no Procurement folder is bound.
GET/api/procurement/requestsList requests for the tenant.
GET/api/procurement/requests/{id}Fetch a single request.
DELETE/api/procurement/requests/{id}Delete a request.
POST/api/procurement/requests/{id}/documentsUpload a supplier document (multipart) into the request folder.
Online terms capture
POST/api/procurement/requests/{id}/capture-termsCapture terms incorporated by reference and version-match them.
GET/api/procurement/requests/{id}/capture-terms/statusPoll capture progress.
Legal review
POST/api/procurement/requests/{id}/reviewRun clmAI Procurement’s legal review.
GET/api/procurement/requests/{id}/review/statusPoll review progress.
POST/api/procurement/reviews/{review_id}/verifyVerifier confirms the review, resolves unverified rows, optionally overrides the recommendation. Rejected while any row is unverified.
Gates & decision
GET/api/procurement/requests/{id}/gatesPreview the approval gates and any blocking reasons.
POST/api/procurement/requests/{id}/decisionApprove or reject. Verifier-gated; approval enforces the diligence gates and returns 409 with blocking reasons if unmet.
Artifacts & policy
GET/api/procurement/requests/{id}/artifact/{kind}Download an artifact: legal-review, gap-analysis, mitigation-rider, summary-agreement or profile-dossier.
GET/api/procurement/policyRead the tenant procurement policy.
PUT/api/procurement/policyUpdate the tenant procurement policy.
GET/api/procurement/context-statusReport whether the 1M-token context window is available for large reviews.
The procurement connector is separate
The purchase-order webhook and spend-cap endpoints (
/api/integrations/procurement/*) belong to the Procurement connector, a different integration.