Developers
The same API the Clauhub app uses: issue and cancel invoices, download your documents from SAT and check your suppliers against the 69-B list. With an API key, or from your AI agents over MCP.
Something custom? Talk to sales →
curl https://clauhub.ai/api/rpc/books/issuance/issue \
-H "x-api-key: $CLAUHUB_API_KEY" \
-H "content-type: application/json" \
-d '{
"json": {
"organizationId": "ORGANIZATION_ID",
"fiscalEntityId": "FISCAL_ENTITY_ID",
"kind": "mx.cfdi",
"attemptId": "0b6f9c1e-6a2d-4f7e-9a51-2f0f6c8f3b10",
"capture": {
"invoiceType": "sale",
"voucherType": "I",
"paymentForm": "03",
"paymentMethod": "PUE",
"currency": "MXN",
"currencyDecimals": 2,
"exportation": "01",
"receiver": {
"rfc": "ICV060329BY0",
"name": "INMOBILIARIA CVA",
"receiverTaxPostalCode": "33826",
"receiverTaxRegime": "601",
"cfdiUsage": "G03"
},
"concepts": [
{
"productServiceCode": "81112100",
"quantity": "1",
"unitCode": "E48",
"description": "Suscripción mensual",
"unitPrice": "239.00",
"taxObject": "02",
"taxes": [
{
"type": "transfer",
"tax": "002",
"factorType": "Tasa",
"taxRate": "0.160000"
}
]
}
]
}
}
}'const capture = {
"invoiceType": "sale",
"voucherType": "I",
"paymentForm": "03",
"paymentMethod": "PUE",
"currency": "MXN",
"currencyDecimals": 2,
"exportation": "01",
"receiver": {
"rfc": "ICV060329BY0",
"name": "INMOBILIARIA CVA",
"receiverTaxPostalCode": "33826",
"receiverTaxRegime": "601",
"cfdiUsage": "G03"
},
"concepts": [
{
"productServiceCode": "81112100",
"quantity": "1",
"unitCode": "E48",
"description": "Suscripción mensual",
"unitPrice": "239.00",
"taxObject": "02",
"taxes": [
{
"type": "transfer",
"tax": "002",
"factorType": "Tasa",
"taxRate": "0.160000"
}
]
}
]
};
const response = await fetch("https://clauhub.ai/api/rpc/books/issuance/issue", {
method: "POST",
headers: {
"x-api-key": process.env.CLAUHUB_API_KEY!,
"content-type": "application/json",
},
body: JSON.stringify({
json: {
organizationId: "ORGANIZATION_ID",
fiscalEntityId: "FISCAL_ENTITY_ID",
kind: "mx.cfdi",
attemptId: "0b6f9c1e-6a2d-4f7e-9a51-2f0f6c8f3b10",
capture,
},
}),
});
const { json: document } = await response.json();
document.state; // "queued"{
"json": {
"id": "ISSUED_DOCUMENT_ID",
"kind": "mx.cfdi",
"state": "queued",
"status": "stamping",
"recipientTaxId": "ICV060329BY0",
"recipientName": "INMOBILIARIA CVA",
"total": "277.24",
"currency": "MXN",
"externalId": null,
"error": null,
"createdAt": "2026-10-25T17:04:12.000Z",
"stampedAt": null
},
"meta": [
[
"date",
"createdAt"
]
]
}An income invoice with 16% VAT. It answers at once with the document queued; stamping runs as a job and the state moves to issued or rejected.
Sending the same attemptId again answers the same document: it never issues twice.
Quickstart
Start with a preview: it stores nothing and uses no stamps.
With your Clauhub account, ask for a key. It is shown once (ch_…); keep it as CLAUHUB_API_KEY.
POST /api/rpc/identity/apiKeys/create
→ "key": "ch_…"Preview a CFDI: it answers the document, its totals and notices. It stores nothing, takes no number and uses no stamps.
POST /api/rpc/books/issuance/preview
→ "totals": { "total": "277.24", … }Issue with an attemptId and read the document: it moves from queued to issued, with its UUID, or to rejected with the reason.
POST /api/rpc/books/issuance/get
→ "state": "issued"What you can do
CFDI invoicing
Preview without storing anything, issue with an attemptId that prevents duplicates, follow the stamping state, cancel, download the XML and PDF or email it. Each stamp uses credits from your balance.
SAT download
Request a month (or some days) of issued or received CFDIs, or their metadata, with your stored e.firma. It is recorded as a job at once; you can also request one document by its UUID.
69-B and 69 lists
Ask whether an RFC is on list 69-B or 69 as of the last daily sync, see which suppliers on your invoices are listed, and verify your CFDIs with SAT, one, up to 500 or all at once.
curl https://clauhub.ai/api/rpc/books/mx/lists/lookup \
-H "x-api-key: $CLAUHUB_API_KEY" \
-H "content-type: application/json" \
-d '{
"json": {
"organizationId": "ORGANIZATION_ID",
"taxId": "ICV060329BY0"
}
}'const response = await fetch("https://clauhub.ai/api/rpc/books/mx/lists/lookup", {
method: "POST",
headers: {
"x-api-key": process.env.CLAUHUB_API_KEY!,
"content-type": "application/json",
},
body: JSON.stringify({
json: { organizationId: "ORGANIZATION_ID", taxId: "ICV060329BY0" },
}),
});
const { json: result } = await response.json();
result.listed; // false{
"json": {
"taxId": "ICV060329BY0",
"listed": false,
"entries": [],
"syncedAt": "2026-10-25T06:00:00.000Z"
},
"meta": [
[
"date",
"syncedAt"
]
]
}Answers whether it is listed, in which situation, and when the list was last synced.
And everything else the app does: every procedure people use is in the API and is an MCP tool.
MCP
An MCP server with the same operations as the API, so your assistant issues, queries and checks for you, with your permissions.
https://clauhub.ai/api/mcpYour MCP client finds where to sign in, registers itself and takes you to approve access (OAuth with PKCE). The consent screen names the app asking.
Send it as Authorization: Bearer ch_… and it works just like x-api-key.
Tools with a name, description and input schema, like books_issuance_issue. Every call is made as you: each service decides with your permissions.
Security
Pricing
$299.52
MXN + VAT per 100 stamps
($347.44 with VAT)
One stamp per CFDI issued, from your credit balance. If stamping is rejected, the credit is released.
API calls a month
On Free and Team, calls past the limit are paid in credits: 1 credit per 100,000.
Create your key and make your first call, or tell us what you want to connect.