List Products

curl --request GET \
  --url https://api.example.com/api/products

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/products"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/products")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "id": 123,
      "nombre": "<string>",
      "descripcion": "<string>",
      "precio": 123,
      "precioOriginal": 123,
      "stock": 123,
      "foto": "<string>",
      "isFeatured": true,
      "peso": 123,
      "alto": 123,
      "ancho": 123,
      "profundidad": 123,
      "categoriaId": 123,
      "marcaId": 123,
      "createdAt": {},
      "updatedAt": {}
    }
  ],
  "meta": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123
  }
}

GET

api

products

List Products

curl --request GET \
  --url https://api.example.com/api/products

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/products"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/products")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "id": 123,
      "nombre": "<string>",
      "descripcion": "<string>",
      "precio": 123,
      "precioOriginal": 123,
      "stock": 123,
      "foto": "<string>",
      "isFeatured": true,
      "peso": 123,
      "alto": 123,
      "ancho": 123,
      "profundidad": 123,
      "categoriaId": 123,
      "marcaId": 123,
      "createdAt": {},
      "updatedAt": {}
    }
  ],
  "meta": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123
  }
}

Endpoint

GET /api/products

Authentication

No authentication required. This is a public endpoint.

Query Parameters

number

default:"1"

Page number for pagination

number

default:"10"

Number of products per page

number

Filter products by category ID

number

Filter products by brand ID (accepts both brandId and marcaId)

string

Search products by name or description

string

Additional filter criteria

string

default:"newest"

Sort order for results (e.g., “newest”, “price-asc”, “price-desc”)

boolean

default:"false"

Return minimal product data (useful for performance optimization)

Response

boolean

Indicates if the request was successful

array

Array of product objects

number

Unique product identifier

string

Product name

string

Product description

decimal

Current product price

decimal

Original price (if product is on sale)

number

Available stock quantity

string

Product image URL

boolean

Whether the product is featured

decimal

Product weight in kg

number

Product height in cm

number

Product width in cm

number

Product depth in cm

number

Associated category ID

number

Associated brand ID

datetime

Product creation timestamp

datetime

Last update timestamp

object

Pagination metadata

number

Current page number

number

Items per page

number

Total number of products

number

Total number of pages

Example Request

curl -X GET "https://api.pcfix.com/api/products?page=1&limit=20&categoryId=5&order=newest"

Example Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "nombre": "Laptop Gaming XYZ",
      "descripcion": "High-performance gaming laptop with RTX graphics",
      "precio": "1299.99",
      "precioOriginal": "1499.99",
      "stock": 15,
      "foto": "https://cdn.pcfix.com/products/laptop-xyz.jpg",
      "isFeatured": true,
      "peso": "2.5",
      "alto": 30,
      "ancho": 40,
      "profundidad": 3,
      "categoriaId": 5,
      "marcaId": 2,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-20T14:45:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

Error Response

{
  "success": false,
  "error": "Error message description"
}

⌘I

Authentication

Products

Cart & Checkout

Sales

Admin

List Products

Endpoint

Authentication

Query Parameters

Response

Example Request

Example Response

Error Response

​Endpoint

​Authentication

​Query Parameters

​Response

​Example Request

​Example Response

​Error Response

Endpoint

Authentication

Query Parameters

Response

Example Request

Example Response

Error Response