List Customers

List all customers for an organization

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

import requests

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

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}/customers', 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}/customers",
  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}/customers"

	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}/customers")

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",
    "legalName": "Dunder Mifflin",
    "taxId": "ABC101010111",
    "taxSystem": "601",
    "email": "email@example.com",
    "defaultInvoiceUse": "G01",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": "142",
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": "86500",
      "state": "Sonora",
      "country": "MEX",
      "interior": "4"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "phone": "6474010101"
  }
]

GET

organizations

{organizationId}

customers

List all customers for an organization

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

import requests

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

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}/customers', 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}/customers",
  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}/customers"

	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}/customers")

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",
    "legalName": "Dunder Mifflin",
    "taxId": "ABC101010111",
    "taxSystem": "601",
    "email": "email@example.com",
    "defaultInvoiceUse": "G01",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": "142",
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": "86500",
      "state": "Sonora",
      "country": "MEX",
      "interior": "4"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "phone": "6474010101"
  }
]

Returns all customers belonging to an organization.

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

Example Request

curl -X GET https://api.timbrix.mx/organizations/550e8400-e29b-41d4-a716-446655440000/customers \
  -H "Authorization: Bearer <your_token>"

Example Response

[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "legalName": "Dunder Mifflin",
    "taxId": "DUM901231AB3",
    "taxSystem": "601",
    "email": "billing@dundermifflin.com",
    "phone": "6474010101",
    "defaultInvoiceUse": "G01",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": "142",
      "interior": null,
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": "86500",
      "state": "Sonora",
      "country": "MEX"
    },
    "createdAt": "2025-01-26T10:00:00Z",
    "updatedAt": "2025-01-26T10:00:00Z"
  }
]

Common Errors

401 Unauthorized

Authentication required.

403 Forbidden

User is not a member of this organization.

Authorizations

Authorization

string

header

required

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

Path Parameters

organizationId

string

required

Response

200 - application/json

string

required

Example:

"590ce6c56d04f840aa8438af"

organizationId

string

required

Example:

"org-uuid"

legalName

string

required

Example:

"Dunder Mifflin"

taxId

string

required

Example:

"ABC101010111"

taxSystem

string

required

Example:

"601"

string

required

Example:

"email@example.com"

defaultInvoiceUse

string

required

Example:

"G01"

address

object

required

Show child attributes

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

phone

object

Example:

"6474010101"

API documentation

Organizations

Members

Invites

Auth

OAuth

Customers

SAT Catalogs

Invoices

Products

Users

Webhooks

API Keys

Authentication

Path Parameters

Example Request

Example Response

Common Errors

401 Unauthorized

403 Forbidden

Authorizations

Path Parameters

Response

​Authentication

​Path Parameters

​Example Request

​Example Response

​Common Errors

​401 Unauthorized

​403 Forbidden

Authorizations

Path Parameters

Response

Authentication

Path Parameters

Example Request

Example Response

Common Errors

401 Unauthorized

403 Forbidden