API Responsesintermediate

Paginated List Response JSON Example

A list response that keeps results and pagination metadata together in a predictable shape.

Real-world use case: Use this for list endpoints, dashboards, and search APIs that need pagination controls.
1{
2 "data": [
3 {
4 "id": "prd_4201",
5 "name": "Performance Tee"
6 },
7 {
8 "id": "prd_4202",
9 "name": "Navy Cap"
10 }
11 ],
12 "meta": {
13 "page": 2,

Where this shape shows up in production

Search APIs
Admin tables
Catalog browsing

Related examples