> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://api.josecarlosonate.com/stock-core-api/products/list-products/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.josecarlosonate.com/_mcp/server. # List Products GET http://localhost:8000/api/v1/products **Endpoint:** `http://localhost:8000/api/v1/products` Returns a paginated list of all products in the catalog. ## Query Parameters | Parameter | Type | Required | Description | | --------- | ------- | -------- | ----------------------------------------- | | `page` | integer | — | Page number for pagination (default: `1`) | ## Response Schema `200 OK` ```json { "data": [ { "id": "integer", "name": "string", "description": "string", "price": "number", "is_active": "boolean", "created_at": "string (ISO 8601)", "updated_at": "string (ISO 8601)", "categories": [ { "id": "integer", "name": "string" } ] } ], "links": { "first": "string", "last": "string", "prev": "string | null", "next": "string | null" }, "meta": { "current_page": "integer", "from": "integer", "last_page": "integer", "per_page": "integer", "to": "integer", "total": "integer" } } ``` Reference: https://api.josecarlosonate.com/stock-core-api/products/list-products ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Response ### 200 OK - `data` (list of ApiV1ProductsGetResponsesContentApplicationJsonSchemaDataItems, required) - `links` (ApiV1ProductsGetResponsesContentApplicationJsonSchemaLinks, required) - `meta` (ApiV1ProductsGetResponsesContentApplicationJsonSchemaMeta, required) ## Types ### ApiV1ProductsGetResponsesContentApplicationJsonSchemaDataItems - `id` (integer, required) - `sku` (string, required) - `name` (string, required) - `slug` (string, required) - `description` (string, required) - `price` (string, required) - `is_active` (boolean, required) - `categories` (list of ApiV1ProductsGetResponsesContentApplicationJsonSchemaDataItemsCategoriesItems, required) ### ApiV1ProductsGetResponsesContentApplicationJsonSchemaLinks - `first` (string, required) - `last` (string, required) - `next` (string, required) - `prev` (any, optional) ### ApiV1ProductsGetResponsesContentApplicationJsonSchemaMeta - `current_page` (integer, required) - `from` (integer, required) - `last_page` (integer, required) - `links` (list of ApiV1ProductsGetResponsesContentApplicationJsonSchemaMetaLinksItems, required) - `path` (string, required) - `per_page` (integer, required) - `to` (integer, required) - `total` (integer, required) ### ApiV1ProductsGetResponsesContentApplicationJsonSchemaDataItemsCategoriesItems - `id` (integer, required) - `name` (string, required) - `slug` (string, required) - `description` (string, required) - `is_active` (boolean, required) ### ApiV1ProductsGetResponsesContentApplicationJsonSchemaMetaLinksItems - `label` (string, required) - `active` (boolean, required) - `url` (any, optional) - `page` (any, optional) ## Examples **Response** ```json { "data": [ { "id": 1, "sku": "SKU-HGOB3V", "name": "error ut", "slug": "error-ut-sku-hgob3v", "description": "Qui quibusdam minus aperiam enim voluptatem harum.", "price": "41807.50", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true } ] }, { "id": 2, "sku": "SKU-WM8XPA", "name": "ipsam qui", "slug": "ipsam-qui-sku-wm8xpa", "description": "Voluptatum amet quidem modi fuga et aut corporis.", "price": "36919.92", "is_active": false, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 3, "sku": "SKU-BUJJAC", "name": "tempore nihil", "slug": "tempore-nihil-sku-bujjac", "description": "Velit quidem unde dolorum magni.", "price": "11820.24", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true } ] }, { "id": 4, "sku": "SKU-JWZCZN", "name": "itaque iure", "slug": "itaque-iure-sku-jwzczn", "description": "Itaque expedita consequuntur suscipit.", "price": "12080.67", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 5, "sku": "SKU-CBWUDP", "name": "provident ex", "slug": "provident-ex-sku-cbwudp", "description": "Ad expedita eos officia nulla corrupti.", "price": "12098.65", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 6, "sku": "SKU-9I1APF", "name": "exercitationem velit", "slug": "exercitationem-velit-sku-9i1apf", "description": "Quam rerum dolorem expedita eligendi enim velit ut.", "price": "37938.55", "is_active": false, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 7, "sku": "SKU-RDFPCT", "name": "ratione quia", "slug": "ratione-quia-sku-rdfpct", "description": "Hic officiis vitae iste est explicabo quod.", "price": "39900.94", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 8, "sku": "SKU-UHZ5JK", "name": "est nesciunt", "slug": "est-nesciunt-sku-uhz5jk", "description": "Nostrum vel neque est quo.", "price": "40017.79", "is_active": true, "categories": [ { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true } ] }, { "id": 9, "sku": "SKU-QYFFBS", "name": "quae dolor", "slug": "quae-dolor-sku-qyffbs", "description": "Temporibus a dolores sit quasi aliquam maiores consequatur.", "price": "23771.85", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true } ] }, { "id": 10, "sku": "SKU-9DFO63", "name": "unde optio", "slug": "unde-optio-sku-9dfo63", "description": "Et ut vel enim eum veritatis.", "price": "19938.08", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 11, "sku": "SKU-BUF7HS", "name": "aliquam et", "slug": "aliquam-et-sku-buf7hs", "description": "Expedita ipsam facilis eligendi aperiam vero quis voluptas.", "price": "35809.74", "is_active": true, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true } ] }, { "id": 12, "sku": "SKU-0TPHS5", "name": "non commodi", "slug": "non-commodi-sku-0tphs5", "description": "Et dolor dolore recusandae asperiores sunt hic facere.", "price": "3239.74", "is_active": false, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 13, "sku": "SKU-HCW43U", "name": "maiores nisi", "slug": "maiores-nisi-sku-hcw43u", "description": "Praesentium deserunt similique et quasi.", "price": "32418.21", "is_active": true, "categories": [ { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false } ] }, { "id": 14, "sku": "SKU-QRKGSO", "name": "est et", "slug": "est-et-sku-qrkgso", "description": "Officia nemo et dolore.", "price": "257.64", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 15, "sku": "SKU-GPG8Y5", "name": "perspiciatis officiis", "slug": "perspiciatis-officiis-sku-gpg8y5", "description": "Officia mollitia voluptatem molestiae.", "price": "46001.58", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 16, "sku": "SKU-ARZNFT", "name": "beatae quaerat", "slug": "beatae-quaerat-sku-arznft", "description": "Provident aliquam tempora omnis tenetur unde hic libero atque.", "price": "44516.60", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true } ] }, { "id": 17, "sku": "SKU-GHWXBX", "name": "in molestias", "slug": "in-molestias-sku-ghwxbx", "description": "Omnis dignissimos enim laborum.", "price": "30012.22", "is_active": false, "categories": [ { "id": 1, "name": "et sapiente", "slug": "et-sapiente", "description": "Quas delectus nulla nemo officiis harum enim officia.", "is_active": true }, { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 18, "sku": "SKU-M6T7PE", "name": "ducimus aperiam", "slug": "ducimus-aperiam-sku-m6t7pe", "description": "Impedit recusandae atque hic necessitatibus et iure omnis.", "price": "34513.39", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false } ] }, { "id": 19, "sku": "SKU-EYOWUE", "name": "fuga voluptatem", "slug": "fuga-voluptatem-sku-eyowue", "description": "Sunt fuga ipsum est id quia ut.", "price": "10660.34", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true }, { "id": 3, "name": "animi voluptatem", "slug": "animi-voluptatem", "description": "Et ducimus tempore delectus quis exercitationem.", "is_active": true }, { "id": 4, "name": "necessitatibus similique", "slug": "necessitatibus-similique", "description": "Rem ducimus dolorem enim impedit accusantium recusandae perferendis nam.", "is_active": false }, { "id": 5, "name": "sint tempore", "slug": "sint-tempore", "description": "Enim veritatis dolorem qui commodi rerum.", "is_active": true } ] }, { "id": 20, "sku": "SKU-UCIVY6", "name": "et sunt", "slug": "et-sunt-sku-ucivy6", "description": "Optio officia ad sed repellendus nesciunt est.", "price": "10192.40", "is_active": true, "categories": [ { "id": 2, "name": "molestiae fuga", "slug": "molestiae-fuga", "description": "Officia soluta magnam suscipit inventore aut perspiciatis.", "is_active": true } ] } ], "links": { "first": "http://localhost:8000/api/v1/products?page=1", "last": "http://localhost:8000/api/v1/products?page=2", "next": "http://localhost:8000/api/v1/products?page=2" }, "meta": { "current_page": 1, "from": 1, "last_page": 2, "links": [ { "label": "« Anterior", "active": false }, { "label": "1", "active": true, "url": null, "page": null }, { "label": "2", "active": false, "url": null, "page": null }, { "label": "Siguiente »", "active": false, "url": null, "page": null } ], "path": "http://localhost:8000/api/v1/products", "per_page": 20, "to": 20, "total": 30 } } ``` **SDK Code** ```python Products_List Products_example import requests url = "http://localhost:8000/api/v1/products" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Products_List Products_example const url = 'http://localhost:8000/api/v1/products'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Products_List Products_example package main import ( "fmt" "net/http" "io" ) func main() { url := "http://localhost:8000/api/v1/products" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Products_List Products_example require 'uri' require 'net/http' url = URI("http://localhost:8000/api/v1/products") http = Net::HTTP.new(url.host, url.port) request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java Products_List Products_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("http://localhost:8000/api/v1/products") .header("Authorization", "Bearer ") .asString(); ``` ```php Products_List Products_example request('GET', 'http://localhost:8000/api/v1/products', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp Products_List Products_example using RestSharp; var client = new RestClient("http://localhost:8000/api/v1/products"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift Products_List Products_example import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "http://localhost:8000/api/v1/products")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```