Skip to main content
GET
/
v1
/
items
List items
curl --request GET \
  --url https://api.neuronsearchlab.com/v1/items \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "data": [
    {
      "id": "7f3a2c9e",
      "object": "item",
      "name": "Wireless Headphones",
      "description": "Noise-cancelling Bluetooth headphones.",
      "metadata": {
        "category": "electronics"
      },
      "active": true,
      "created": 1777478400,
      "updated_at": 1777478500
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "url": "/v1/items"
}

​
Request

GET /v1/items?limit=20&starting_after=7f3a2c9e
ParameterTypeRequiredDescription
limitintegernoNumber of items to return. Defaults to 20, maximum 100.
starting_afterstringnoItem ID cursor from a previous response.
categorystringnoFilters by metadata.category.
created_afterintegernoUnix timestamp lower bound for created.
created_beforeintegernoUnix timestamp upper bound for created.

​
Response

{
  "object": "list",
  "data": [
    {
      "id": "7f3a2c9e",
      "object": "item",
      "name": "Wireless Headphones",
      "description": "Noise-cancelling Bluetooth headphones.",
      "metadata": {
        "category": "electronics"
      },
      "active": true,
      "created": 1777478400,
      "updated_at": 1777478400
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "url": "/v1/items"
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
limit
integer
default:20

Maximum number of resources to return. Defaults to 20 and is capped at 100.

Required range: 1 <= x <= 100
​
starting_after
string

Cursor from a previous item list response.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$
​
category
string

Filter by metadata.category.

​
created_after
integer<int64>

Return items created at or after this Unix timestamp in seconds.

Required range: x >= 1
​
created_before
integer<int64>

Return items created at or before this Unix timestamp in seconds.

Required range: x >= 1

Response

Paginated item list

​
object
enum<string>
required
Available options:
list
​
data
object[]
required
​
has_more
boolean
required
​
url
string
required
​
next_cursor
string | null