List purchase order items

Returns a list of items for a specific purchase order. Each item represents a portion of the total purchase amount and can be independently approved and linked to invoices.

Key Features

  • Item Details: Full information about each item including name, percentage, and calculated amount
  • Approval Status: Current review status and approval history
  • Invoice Linking: Shows which items are linked to fiscal invoices
  • Reviewer Information: Lists assigned reviewers and their approval levels

Authorization

  • User must be a member of the company that owns the purchase order

Response Structure

The response includes detailed item information along with:

  • payable: Linked fiscal invoice details (if item is linked to an invoice)
  • reviewers: List of users assigned to review this item
  • reviews: Complete approval/rejection history for the item

Common Use Cases

  1. Check approval status: View which items are pending, approved, or rejected
  2. Track invoice linking: See which items have been linked to received invoices
  3. Monitor review progress: Check which reviewers have approved each item
  4. Audit trail: Review complete history of approvals and rejections
Path Params
uuid
required

ID of the purchase order

Query Params
string

Filter items by review status. Supports JSON operators:

  • Single status: "approved"
  • Multiple statuses: {"$in": ["pending", "approved"]}
  • Exclude status: {"$ne": "declined"}

Available statuses:

  • pending: Awaiting review
  • in_review: Under review
  • approved: Approved by all required reviewers
  • declined: Rejected by at least one reviewer
string

Filter items by invoice linking status:

  • Linked items: {"$ne": null}
  • Unlinked items: null
Headers
uuid
required

ID of the company

Responses

Language
Credentials
Bearer
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json