List Purchase Orders

curl --request GET \
  --url https://staging.cutmake.ai/api/v1/purchase-orders/fixed-cost \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "purpose": "<string>",
      "expenseCategory": "<string>",
      "frequency": "<string>",
      "total": "<string>",
      "currency": "<string>",
      "status": "<string>",
      "createdAt": "<string>",
      "createdBy": "<string>",
      "vendorName": "<string>",
      "employeeName": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123,
    "hasNext": true,
    "hasPrev": true
  }
}

Fixed Cost Purchase Orders

List Purchase Orders

List Fixed Cost Purchase Orders with pagination, filtering, and sorting.

Filtering:

status: Filter by PO status (Draft, Submitted, Approved, Rejected, Cancelled)
expenseCategory: Filter by expense category (utilities, rent, services, etc.)
frequency: Filter by frequency (one_time, monthly, quarterly, yearly)

Sorting:

Prefix with - for descending, + or no prefix for ascending
Supported fields: created_at, document_id, status

Search:

Searches in document_id field

Response Format:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 45,
    "totalPages": 5,
    "hasNext": true,
    "hasPrev": false
  }
}

GET

api

purchase-orders

fixed-cost

List Purchase Orders

curl --request GET \
  --url https://staging.cutmake.ai/api/v1/purchase-orders/fixed-cost \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "purpose": "<string>",
      "expenseCategory": "<string>",
      "frequency": "<string>",
      "total": "<string>",
      "currency": "<string>",
      "status": "<string>",
      "createdAt": "<string>",
      "createdBy": "<string>",
      "vendorName": "<string>",
      "employeeName": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123,
    "hasNext": true,
    "hasPrev": true
  }
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

page

integer

default:1

Page number

Required range: x >= 1

limit

integer

default:10

Items per page

Required range: 1 <= x <= 100

status

string | null

Filter by status

expenseCategory

string | null

Filter by expense category

frequency

string | null

Filter by frequency

string | null

Search in document ID

sort

string

default:-created_at

Sort field with direction prefix

Response

Successful Response

Paginated response for Fixed Cost PO list

data

FixedCostPOListItem · object[]

required

Show child attributes

pagination

PaginationInfo · object

required

Pagination metadata following API standards.

Attributes: page: Current page number (1-indexed) limit: Items per page total: Total number of items matching query totalPages: Total number of pages hasNext: Whether there is a next page hasPrev: Whether there is a previous page

Show child attributes

Update Purchase Order Create Purchase Order

⌘I

API Keys

Authentication

Bank Statements

Bills

BOM

Budgets

Clients

Delivery Notes

Direct Cost Purchase Orders

Fixed Cost Purchase Orders

Invoices

Management Accounts

Materials

Labor Cost

Production Orders

Production Lines

Sales Orders

Styles

SKUs

Suppliers

Webhooks

Users

List Purchase Orders

Authorizations

Query Parameters

Response