List Products

List products for an organization

curl --request GET \
  --url https://api.timbrix.mx/organizations/{organizationId}/products \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.timbrix.mx/organizations/{organizationId}/products"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.timbrix.mx/organizations/{organizationId}/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.timbrix.mx/organizations/{organizationId}/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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.timbrix.mx/organizations/{organizationId}/products"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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.timbrix.mx/organizations/{organizationId}/products")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "org-uuid",
    "livemode": false,
    "description": "Ukelele",
    "productKey": 60131324,
    "price": 345.6,
    "taxIncluded": true,
    "taxability": "01",
    "taxes": [
      {
        "type": "IVA",
        "rate": 0.16,
        "withholding": false,
        "factor": "Tasa"
      }
    ],
    "localTaxes": [
      {
        "type": "IVA",
        "rate": 0.16,
        "withholding": false,
        "factor": "Tasa"
      }
    ],
    "unitKey": "H87",
    "unitName": "Elemento",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "sku": "UKL-001"
  }
]

GET

organizations

{organizationId}

products

List products for an organization

curl --request GET \
  --url https://api.timbrix.mx/organizations/{organizationId}/products \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.timbrix.mx/organizations/{organizationId}/products"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.timbrix.mx/organizations/{organizationId}/products', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.timbrix.mx/organizations/{organizationId}/products",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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.timbrix.mx/organizations/{organizationId}/products"

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

	req.Header.Add("Authorization", "Bearer <token>")

	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.timbrix.mx/organizations/{organizationId}/products")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "org-uuid",
    "livemode": false,
    "description": "Ukelele",
    "productKey": 60131324,
    "price": 345.6,
    "taxIncluded": true,
    "taxability": "01",
    "taxes": [
      {
        "type": "IVA",
        "rate": 0.16,
        "withholding": false,
        "factor": "Tasa"
      }
    ],
    "localTaxes": [
      {
        "type": "IVA",
        "rate": 0.16,
        "withholding": false,
        "factor": "Tasa"
      }
    ],
    "unitKey": "H87",
    "unitName": "Elemento",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "sku": "UKL-001"
  }
]

Returns all products and services in the organization’s catalog. Supports optional filtering by description, SKU, or product key.

Authentication

Requires a valid Bearer token. The authenticated user must be a member of the organization.

Path Parameters

Parameter	Type	Required	Description
`organizationId`	string (UUID)	Yes	Organization ID

Query Parameters

Parameter	Type	Required	Description
`description`	string	No	Filter by description (partial, case-insensitive)
`sku`	string	No	Filter by SKU (partial, case-insensitive)
`productKey`	integer	No	Filter by SAT product key (exact match)

Example Request

curl https://api.timbrix.mx/organizations/550e8400-e29b-41d4-a716-446655440000/products?description=Ukelele \
  -H "Authorization: Bearer <your_token>"

Example Response

[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "livemode": true,
    "description": "Ukelele",
    "productKey": 60131324,
    "price": 345.6,
    "taxIncluded": true,
    "taxability": "01",
    "taxes": [{ "type": "IVA", "rate": 0.16 }],
    "localTaxes": [],
    "unitKey": "H87",
    "unitName": "Elemento",
    "sku": "UKL-001",
    "createdAt": "2025-01-26T10:00:00Z",
    "updatedAt": "2025-01-26T10:00:00Z"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organizationId

string

required

Query Parameters

description

string

Filter by description (partial match)

Example:

"Ukelele"

sku

string

Filter by SKU (partial match)

Example:

"UKL"

productKey

number

Filter by SAT product key (exact match)

Example:

60131324

Response

200 - application/json

string

required

Example:

"590ce6c56d04f840aa8438af"

organizationId

string

required

Example:

"org-uuid"

livemode

boolean

required

Example:

false

description

string

required

Example:

"Ukelele"

productKey

number

required

Example:

60131324

price

number

required

Example:

345.6

taxIncluded

boolean

required

Example:

true

taxability

string

required

Example:

"01"

taxes

object[]

required

Show child attributes

localTaxes

object[]

required

Show child attributes

unitKey

string

required

Example:

"H87"

unitName

string

required

Example:

"Elemento"

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

sku

object

Example:

"UKL-001"

API documentation

Organizations

Members

Invites

Auth

OAuth

Customers

SAT Catalogs

Invoices

Products

Users

Webhooks

API Keys

Authentication

Path Parameters

Query Parameters

Example Request

Example Response

Authorizations

Path Parameters

Query Parameters

Response

​Authentication

​Path Parameters

​Query Parameters

​Example Request

​Example Response

Authorizations

Path Parameters

Query Parameters

Response

Authentication

Path Parameters

Query Parameters

Example Request

Example Response