List procurements

GET 
/openapi/2026-07/procurements

Retrieves a list of Procurement objects, representing the associations between products and Procurementions.

Request

Query Parameters

cursor string

Cursor for pagination

page_size int32

A limit on the number of objects to return. Range: 1-100 (default is 10)

ids string[]

Array of procurement IDs to filter by. Example: ?ids=1001&ids=1002

state int32

Procurement state filter. Accepted values: 1 (waiting for stock), 2 (partial receipt), 3 (complete receipt), 4 (cancelled)

created_at_min string

Filter procurements created at or after this date (ISO-8601 format)

created_at_max string

Filter procurements created at or before this date (ISO-8601 format)

updated_at_min string

Filter procurements updated at or after this date (ISO-8601 format)

updated_at_max string

Filter procurements updated at or before this date (ISO-8601 format)

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

procurements object[]

List of procurements

Array [

idstring

Procurement ID

procurement_snstring

Procurement serial number

supplier_idstring

Supplier ID

location_idstring

Location ID

notestring

Note or remark

stateint32

Procurement state

pending_quantityint32

Pending quantity

received_quantityint32

Received quantity

rejected_quantityint32

Rejected quantity

transfer_quantityint32

Transfer quantity

created_bystring

Created by

created_atstring

Creation timestamp, in ISO-8601 format

updated_atstring

Last update timestamp, in ISO-8601 format

]

cursorstring

Cursor for pagination

has_moreboolean

Whether there are more records

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "procurements": [
      {
        "id": "string",
        "procurement_sn": "string",
        "supplier_id": "string",
        "location_id": "string",
        "note": "string",
        "state": 0,
        "pending_quantity": 0,
        "received_quantity": 0,
        "rejected_quantity": 0,
        "transfer_quantity": 0,
        "created_by": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}