Paginated list of products. Supports filtering, range operators (`_gte`, `_lte`, `_gt`, `_lt`, `_ne`, `_like`), full-text search, sorting, field selection, and relation expansion.

Parameters 12

Name	Type	Description
`_page`	query · integer	Page number (1-based)
`_limit`	query · integer	Items per page
`_start`	query · integer	Slice start index (alternative to page-based)

ReturnsProduct

Bearer token required

Response examples

200Paginated array of products

application/json example derived from schema

[
  {
    "id": 1,
    "categoryId": 4,
    "name": "Desk Lamp",
    "description": "Ultra-fast connectivity with rock-solid reliability.",
    "price": 161.28,
    "originalPrice": 231.38,
    "currency": "USD",
    "stock": 257,
    "sku": "SKU-00001",
    "rating": 4.4,
    "reviewCount": 188,
    "image": "https://picsum.photos/seed/prod1/400/400",
    "images": [
      "https://picsum.photos/seed/prod1-0/400/400",
      "https://picsum.photos/seed/prod1-1/400/400",
      "https://picsum.photos/seed/prod1-2/400/400",
      "https://picsum.photos/seed/prod1-3/400/400",
      "https://picsum.photos/seed/prod1-4/400/400"
    ],
    "weight": 9.19,
    "dimensions": {
      "width": 33.4,
      "height": 40,
      "depth": 14.6
    },
    "isAvailable": true,
    "isFeatured": false,
    "tags": [
      "backend"
    ],
    "createdAt": "2024-05-30T01:37:26.059Z",
    "updatedAt": "2026-12-15T02:55:19.943Z"
  }
]

429429 — rate limit exceeded (120/60s)

application/json

{
  "error": {
    "status": 429,
    "message": "Too many requests",
    "details": {
      "retryAfter": 45
    }
  }
}

Code examples

curl -H 'Authorization: Bearer <TOKEN>' 'https://api.rodin.dev/mock/products'

fetch("https://api.rodin.dev/mock/products", {
  method: "GET",
  headers: {
      "Authorization": "Bearer <TOKEN>"
    },
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/products"
headers = {
    "Authorization": "Bearer <TOKEN>"
}

response = requests.get(url, headers=headers)
print(response.json())

Authentication

AuthenticationBearer token

Paste cURL