Get a list of contract items
The request address contains the code of the workspace that the contract is located in ({namespace}) and the code of the contract ({code}).
The request body contains the description of the requested list’s parameters that sets filters and sorting.
Request
POST /pub/v1/contracts/{namespace}/{code}/list
Path parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| namespace | string | Workspace code |
Required |
| code | string | Contract code |
Required |
Request body
The resource sent in the request body is Get a list of contract items — Request. It contains the following writable properties:
{
"active": "boolean",
"filter": {
"<key>": {}
},
"from": "int64",
"ids": [
"uuid"
],
"size": "int64",
"sortExpressions": [
{
"ascending": "boolean",
"field": "string"
}
]
}
Properties
| Name | Type | Description | Additional |
|---|---|---|---|
| active | boolean |
Show active only (not deleted) |
Optional |
| filter | object |
Filtering |
Optional |
| filter.<key> | map of object | Optional | |
| from | int64 |
Return from item |
Optional |
| ids[] | array of uuid |
Filter by ID |
Optional |
| size | int64 |
Number of returned items (10000 max) |
Optional |
| sortExpressions[] | array |
Sorting rules |
Optional |
| sortExpressions[].ascending | boolean |
Ascending sorting order flag |
Optional |
| sortExpressions[].field | string |
Sort field |
Optional |
Authorization
This request requires the use of one of following authorisation methods:
API key
Response
The following HTTP status codes may be returned:
| Status code | Description | Resource |
|---|---|---|
| 200 | OK Model of a list of contract items |
Model of a list of contract items (Get a list of contract items) |
| 400 | Bad Request Invalid request parameters |