Skip to main content

​
Welcome to Timbrix API

The Timbrix API lets you integrate CFDI 4.0 electronic invoicing into your own applications. Use it to manage organizations, customers, products, webhooks, and OAuth integrations programmatically.

OpenAPI Specification

View the complete OpenAPI 3.0 specification

​
Base URL

All requests must be sent to:

​
Getting started

  1. Create a Timbrix account
  2. Create an API key from your organization settings
  3. Make your first request using the examples in this reference
Use the @timbrix/sdk TypeScript SDK or the @timbrix/cli CLI to get started faster.

​
Authentication

The API supports two authentication methods depending on your integration type:

​
API Key

Recommended for server-to-server integrations. Create a key in your organization settings and include it in every request:

​
OAuth 2.0

Use OAuth when your application needs to act on behalf of a Timbrix user. Timbrix supports:
  • Client Credentials — machine-to-machine access
  • Authorization Code — user consent flow with redirect
See the OAuth endpoints for token generation and the Authorization Code flow.

​
Rate limiting

Requests are rate-limited based on your subscription plan. If you exceed your limit, the API returns 429 Too Many Requests. Contact support if you need higher limits.

​
Error responses

The API returns standard HTTP status codes: Error responses include a message with details:

​
Next steps

API Keys

Create and manage API keys for your integration

Organizations

Manage organizations and fiscal settings

Webhooks

Receive real-time event notifications

OAuth

Build apps that authenticate on behalf of users