Get PO candidates for an invoice
GET/invoices/:code/matching/candidates
Returns the stored purchase-order candidates for an invoice, narrowed to what this caller may act on. A caller holding the ACCOUNTANT role receives the stored set as it is. Every other caller receives only the orders they requested or buy, and also loses any candidate whose purchase order no longer resolves. A row withheld here is a row that caller could not have selected, so an absent row does not mean the matcher found no candidate. The stored set itself is drawn from a tenant-wide search only for an invoice that reached no personal inbox; for one that did, the search is scoped to that recipient's own orders, and only an order the document or a card charge named is stored past that scope.
Request
Responses
- 200
- 401
- 403
- 404
- 429
- 500
OK
Unauthorized
Forbidden - request denied by authorization, or blocked by the API firewall
Invoice not found or not accessible
Too many requests - rate limited by the API firewall; wait out the Retry-After delay before retrying
Response Headers
Delay in seconds a client must wait before retrying the request
Internal server error