Retrieves a list of procurement records with optional filters such as state, creation date, or update date.
Requiresread_inventoryaccess scope. More access scope
The Get Procurement List API allows users to retrieves detailed information about a specific procurement record.
This API is especially useful for:
- Viewing complete procurement order information
- Checking receipt progress and status
- Auditing supplier deliveries
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
procurement_id | string | Yes | Unique procurement identifier | "proc_12345" |
Response Explanation
Public Response Parameters
Successful Response
| Parameter | Type | Example | Description |
|---|---|---|---|
code | string | "success" | Status code of the API response |
message | string | "Order retrieved successfully" | Descriptive message about the response |
data.procurements | array[object] | - | List of procurement objects |
data.cursor | string | "def456" | Pagination token |
data.has_more | boolean | true | More results available |
Procurement Object
Parameter | Type | Example | Description |
|---|---|---|---|
| string |
| Unique procurement ID |
| string |
| Procurement serial number |
| string |
| Supplier reference ID |
| string |
| Warehouse location ID |
| string |
| Procurement notes |
| int32 |
| Current state (1-4) |
| int32 |
| Items awaiting receipt |
| int32 |
| Items successfully received |
| int32 |
| Items rejected |
| int32 |
| Items in transit |
| string |
| Creator user ID |
| string |
| Creation timestamp |
| string |
| Last update timestamp |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |