Items
GET /v1/items
List items with pagination, free-text search, and an optional trash-only filter.
GET /v1/items returns a paginated list of items.
Authentication
Send an organization API key in x-api-key or
Authorization: Bearer <key>.
Query Parameters
| Name | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number to return. |
limit | integer | 20 | Number of results per page. Maximum: 100. |
q | string | "" | Free-text search term. |
deletedOnly | boolean | false | When true, only trashed items are returned. |
Example
curl "https://api.blueputto.com/v1/items?page=1&limit=20&q=chair&deletedOnly=false" \
-H "x-api-key: YOUR_API_KEY"Success Response
200 OK
{
"data": [{}],
"meta": {
"page": 1,
"limit": 20,
"totalItems": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPrevPage": false
}
}Error Responses
400 Bad Request401 Unauthorized429 Too Many Requests