API Reference

Generated from the same contract as openapi.json(OpenAPI 3.1). Version 2026-10-01.Every response comes in { data }; errors, in { error, code, request_id, doc_url }.

Account

GET`/api/v1/me`

Organization and key scopescope: read

curl https://cordhq.app/api/v1/me \
  -H "Authorization: Bearer sk_test_..."

const me = await cord.me();

Response: data

`org`	`object`	Organization that owns the key.
`scope`	`string`	read or write: what the key can do.
`mode`	`"live" \| "test"`	live or test: with test, everything happens in the sandbox and never touches real data.

Quotes

GET`/api/v1/cotizaciones`

List quotesscope: readOffset pagination

Query parameters: limit, offset, cursor, status, folio, cliente_id

curl https://cordhq.app/api/v1/cotizaciones \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.quotes.listAll()) {
  console.log(item.id);
}

Response: data[]

`id`	`string`	Identifier (UUID).
`folio`	`string`	Human-readable number assigned by Cord, for example COT-0042.
`cliente`	`string \| null`	Client the document is addressed to: the company name, or the details to create the client if it does not exist.
`status`	`string`	Quote status: draft, sent, viewed, approved, rejected, expired, paid or invoiced.
`total`	`number`	Amount in the currency given by `moneda`.
`moneda`	`string \| null`	ISO 4217 currency code.
`terminos`	`string \| null`	Human-readable label for the payment terms in the account's language ("Due on receipt", "Net 45"); to compare, use terminos_codigo.
`terminos_codigo`	`string \| null`	Stable payment terms code: contado or net<N> (net7, net15, net30, net45, net60, net90).
`vigencia`	`string \| null`	ISO 8601 date.
`creada`	`string \| null`	ISO 8601 date.
`link_publico`	`string`	Absolute public link to the quote.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Read-only. Language the quote was sent in: es, en, pt, fr or de. null while it is a draft, which follows the client's language.

POST`/api/v1/cotizaciones`

Create a quoteAccepts pk_scope: write

Field	Type	Description
`items` required	`object[]`	Line items.
`cliente_id`	`string`	ID of a client in the directory.
`cliente`	`object`	Client the document is addressed to: the company name, or the details to create the client if it does not exist.
`terminos`	`"contado" \| "net7" \| "net15" \| "net30" \| "net45" \| "net60" \| "net90"`	Payment terms: contado or net<N> (N days of credit: 7, 15, 30, 45, 60 or 90).
`vigencia_dias`	`integer`	Number of days the quote is valid after it is sent.
`notas`	`string`	Internal notes; the client does not see them.
`base_currency`	`string`	ISO 4217 sales currency: the one prices are entered in, payment is collected in and the invoice is issued in. Default: the business's currency.
`fiscal_currency`	`string`	ISO 4217 accounting currency; if it differs from the sales currency, the invoice states the exchange rate.
`iva_incluido`	`boolean`	true if the prices entered already include tax.
`descuento`	`object \| null`	Document discount before tax, spread across line items in proportion to their amount. Cord calculates the amount; null removes it.
`cupon`	`string`	Code of one of the business's coupons. Cord checks its validity, currency and redemptions; if present, it takes precedence over descuento. It is the only discount a publishable key accepts.
`send`	`boolean`	Secret Key only.

curl -X POST https://cordhq.app/api/v1/cotizaciones \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"cliente":{"empresa":"Acme"},"items":[{"descripcion":"Instalación","cantidad":1,"precio_unitario":12500,"tax_rate":0.16}],"base_currency":"MXN"}'

const created = await cord.quotes.create({
  "cliente": {
    "empresa": "Acme"
  },
  "items": [
    {
      "descripcion": "Instalación",
      "cantidad": 1,
      "precio_unitario": 12500,
      "tax_rate": 0.16
    }
  ],
  "base_currency": "MXN"
});

Response: data

`id`	`string`	Identifier (UUID).
`token`	`string`	Token of the public link. It is a credential: do not publish it.
`folio`	`string`	Human-readable number assigned by Cord, for example COT-0042.
`link_publico`	`string`	Absolute public link shared with the client.
`needs_approval`	`boolean`	true if it was held for internal approval before being sent.
`motivo`	`string \| null`	Reason, written by a person.
`email`	`object`	Email address.

GET`/api/v1/cotizaciones/{id}`

Retrieve a quotescope: read

curl https://cordhq.app/api/v1/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..."

const item = await cord.quotes.retrieve('ID');

Response: data

`id`	`string`	Identifier (UUID).
`folio`	`string`	Human-readable number assigned by Cord, for example COT-0042.
`cliente`	`string \| null`	Client the document is addressed to: the company name, or the details to create the client if it does not exist.
`status`	`string`	Quote status: draft, sent, viewed, approved, rejected, expired, paid or invoiced.
`total`	`number`	Amount in the currency given by `moneda`.
`moneda`	`string \| null`	ISO 4217 currency code.
`terminos`	`string \| null`	Human-readable label for the payment terms in the account's language ("Due on receipt", "Net 45"); to compare, use terminos_codigo.
`terminos_codigo`	`string \| null`	Stable payment terms code: contado or net<N> (net7, net15, net30, net45, net60, net90).
`vigencia`	`string \| null`	ISO 8601 date.
`creada`	`string \| null`	ISO 8601 date.
`link_publico`	`string`	Absolute public link to the quote.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Read-only. Language the quote was sent in: es, en, pt, fr or de. null while it is a draft, which follows the client's language.
`notas`	`string \| null`	Internal notes; the client does not see them.
`aprobacion`	`object \| null`	Internal approval required by a business rule; null if it does not apply.
`items`	`object[]`	Line items.
`descuento`	`object \| null`	Document discount, applied before tax and spread across line items; null if there is none. subtotal is already net.
`eventos`	`object[]`	List of events or event types. Empty = all.

POST`/api/v1/cotizaciones/{id}`

Send, resend, approve, reject or mark as paidscope: write

Field	Type	Description
`action` required	`"send" \| "resend" \| "approve" \| "reject" \| "mark_paid"`	Action to run; each one requires the right prior status and is idempotent with Idempotency-Key.
`payment_method`	`string`	Payment method when marking it as paid: transferencia, efectivo, tarjeta…

curl -X POST https://cordhq.app/api/v1/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"send"}'

await cord.quotes.send('ID');

Response: data

id string Identifier (UUID).

DELETE`/api/v1/cotizaciones/{id}`

Delete a draftscope: write

curl -X DELETE https://cordhq.app/api/v1/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..."

await cord.quotes.del('ID');

Response: data

id string Identifier (UUID).

POST`/api/v1/cotizaciones/ia`

Suggest line items from the text of an orderscope: write

Field	Type	Description
`texto` required	`string`	Free text of the order.

curl -X POST https://cordhq.app/api/v1/cotizaciones/ia \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"texto":"…"}'

const { items } = await cord.quotes.draftFromText('5 sacos de cemento');

Response: data

`items`	`any[]`	Line items.
`moneda`	`string`	ISO 4217 currency of the amounts.

Clients

GET`/api/v1/clientes`

List clientsscope: readOffset pagination

Query parameters: limit, offset, cursor, q, email

curl https://cordhq.app/api/v1/clientes \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.clients.listAll()) {
  console.log(item.id);
}

Response: data[]

`id`	`string`	Identifier (UUID).
`empresa`	`string`	Name of the company or person.
`contacto`	`string`	Name of the contact person.
`email`	`string`	Email address.
`telefono`	`string`	Phone number with the international dialing code.
`rfc`	`string`	Tax ID: RFC, NIF, EIN…
`terminos`	`string`	Human-readable label for the payment terms.
`terminosCode`	`string`	Payment terms code: contado or net<N> (net7, net15, net30, net45, net60, net90).
`limite`	`number`	The client's credit limit, in the business's currency.
`nivel`	`string`	The client's tier or segment.
`descuentoPct`	`number`	The client's default discount, as a percentage.
`regimenFiscal`	`string`	SAT tax regime code (Mexico).
`usoCfdi`	`string`	CFDI use code (Mexico).
`cpFiscal`	`string`	Postal code of the tax address (Mexico).
`countryCode`	`string`	ISO 3166-1 alpha-2 country code.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Language of the documents the client receives: es, en, pt, fr or de; null = the organization's. Quotes and invoices keep the language they were sent or issued in; changing it does not rewrite what was already sent. Any other value responds 400 with field: language.

POST`/api/v1/clientes`

Create a clientscope: write

Field	Type	Description
`empresa` required	`string`	Name of the company or person.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Language of the documents the client receives: es, en, pt, fr or de; null = the organization's. Quotes and invoices keep the language they were sent or issued in; changing it does not rewrite what was already sent. Any other value responds 400 with field: language.

curl -X POST https://cordhq.app/api/v1/clientes \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"empresa":"…"}'

const created = await cord.clients.create({
  "empresa": "…"
});

Response: data

id string Identifier (UUID).

GET`/api/v1/clientes/{id}`

Retrieve a clientscope: read

curl https://cordhq.app/api/v1/clientes/ID \
  -H "Authorization: Bearer sk_test_..."

const item = await cord.clients.retrieve('ID');

Response: data

`id`	`string`	Identifier (UUID).
`empresa`	`string`	Name of the company or person.
`contacto`	`string`	Name of the contact person.
`email`	`string`	Email address.
`telefono`	`string`	Phone number with the international dialing code.
`rfc`	`string`	Tax ID: RFC, NIF, EIN…
`terminos`	`string`	Human-readable label for the payment terms.
`terminosCode`	`string`	Payment terms code: contado or net<N> (net7, net15, net30, net45, net60, net90).
`limite`	`number`	The client's credit limit, in the business's currency.
`nivel`	`string`	The client's tier or segment.
`descuentoPct`	`number`	The client's default discount, as a percentage.
`regimenFiscal`	`string`	SAT tax regime code (Mexico).
`usoCfdi`	`string`	CFDI use code (Mexico).
`cpFiscal`	`string`	Postal code of the tax address (Mexico).
`countryCode`	`string`	ISO 3166-1 alpha-2 country code.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Language of the documents the client receives: es, en, pt, fr or de; null = the organization's. Quotes and invoices keep the language they were sent or issued in; changing it does not rewrite what was already sent. Any other value responds 400 with field: language.

PATCH`/api/v1/clientes/{id}`

Update contact detailsscope: write

Field	Type	Description
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Language of the documents the client receives: es, en, pt, fr or de; null = the organization's. Quotes and invoices keep the language they were sent or issued in; changing it does not rewrite what was already sent. Any other value responds 400 with field: language.

curl -X PATCH https://cordhq.app/api/v1/clientes/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'

await cord.clients.update('ID', { email: 'compras@acme.mx' });

Response: data

id string Identifier (UUID).

Products

GET`/api/v1/productos`

List productsAccepts pk_scope: readOffset pagination

Query parameters: limit, offset, cursor

curl https://cordhq.app/api/v1/productos \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.products.listAll()) {
  console.log(item.id);
}

Response: data[]

`id`	`string`	Identifier (UUID).
`sku`	`string`	Internal product code.
`nombre`	`string`	Name.
`unidad`	`string`	Unit of measure: piece, kg, hour…
`descripcion`	`string`	Description as the client sees it.
`precio`	`number`	Amount in the currency given by `moneda`.
`costo`	`number`	Never exposed to a publishable key.
`activo`	`boolean`	false if it is deactivated: it is kept but not used.
`createdAt`	`string \| null`	ISO 8601 date.
`preciosVolumen`	`object[]`	Tiered prices by quantity.
`existencias`	`number \| null`	Units in stock; null if inventory is not tracked.
`taxRate`	`number \| null`	Tax suggested when the product is added to a line item, as a 0–1 fraction; null = the organization's default.
`claveSat`	`string \| null`	SAT product or service code (c_ClaveProdServ, 8 digits) for the CFDI in Mexico; null if it has not been classified.
`claveUnidadSat`	`string \| null`	SAT unit code (c_ClaveUnidad, such as H87 or E48) for the CFDI in Mexico; null = derived from the unit.

POST`/api/v1/productos`

Create a productscope: write

Field	Type	Description
`nombre` required	`string`	Name.

curl -X POST https://cordhq.app/api/v1/productos \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"nombre":"…"}'

const created = await cord.products.create({
  "nombre": "…"
});

Response: data

id string Identifier (UUID).

Invoices

GET`/api/v1/facturas`

List invoicesscope: readCursor pagination

Query parameters: limit, cursor, estado, cliente, desde, hasta, q

curl https://cordhq.app/api/v1/facturas \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.invoices.listAll()) {
  console.log(item.id);
}

Response: data[]

`id`	`string`	Identifier (UUID).
`numero`	`string \| null`	Invoice number within its series.
`folio_fiscal`	`string \| null`	Identifier with the tax authority (the CFDI UUID in Mexico); null if it does not apply.
`cliente`	`string \| null`	Client the document is addressed to: the company name, or the details to create the client if it does not exist.
`estado`	`string`	draft, open, paid, void or uncollectible.
`estado_fiscal`	`string`	Issuance status: pending, issued, cancelled or error.
`pais`	`string`	ISO 3166-1 alpha-2 country code.
`tipo`	`string`	Document type: cfdi_40, cfdi_egreso, proforma, commercial_invoice, commercial_credit_note, verifactu_invoice or verifactu_credit_note.
`documento`	`"factura" \| "factura_proforma" \| "nota_credito" \| "nota_debito"`	How the document is titled. factura_proforma is a pro forma invoice: it is not an invoice and is not valid for tax purposes. It covers the proforma type and, in Spain, any document without a Verifactu record.
`moneda`	`string \| null`	ISO 4217 currency code.
`total`	`number`	Amount in the currency given by `moneda`.
`pagado`	`number`	Amount in the currency given by `moneda`.
`saldo`	`number`	Amount in the currency given by `moneda`.
`vence`	`string \| null`	ISO 8601 date.
`vencida`	`boolean`	true if the due date has passed with a balance due.
`cotizacion_id`	`string \| null`	ID of the related quote.
`creada`	`string \| null`	ISO 8601 date.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Read-only. Language the invoice was issued in: es, en, pt, fr or de. null while it is a draft.

POST`/api/v1/facturas`

Create a draft invoicescope: write

Field	Type	Description
`cliente_id` required	`string`	ID of a client in the directory.
`items` required	`object[]`	Line items.
`currency`	`string`	ISO 4217 currency code.
`due_date`	`string`	Due date, YYYY-MM-DD.
`service_date`	`string`	Date the service was provided or the goods delivered (Leistungsdatum), YYYY-MM-DD. Without it, the invoice states that it matches the issue date.
`service_date_end`	`string`	End of the service period, YYYY-MM-DD. Requires service_date and cannot be earlier.
`notas`	`string`	Internal notes; the client does not see them.
`iva_incluido`	`boolean`	true if the prices entered already include tax.
`document_mode`	`"commercial" \| "fiscal"`	commercial or fiscal. Without it, fiscal if the plan includes it and it is enabled for the country; fiscal without those responds 400.
`fx_buffer_pct`	`number`	Buffer in percentage points over the reference exchange rate (2 = +2%); capped at 25. Default 0.
`descuento`	`object \| null`	Document discount before tax, spread across line items in proportion to their amount. Cord calculates the amount; null removes it.
`cupon`	`string`	Code of one of the business's coupons. Cord checks its validity, currency and redemptions; if present, it takes precedence over descuento. It is the only discount a publishable key accepts.
`buyer_reference`	`string`	Buyer reference for their accounts payable (in Germany, the public administration's Leitweg-ID). The European e-invoice carries it (BT-10) and XRechnung requires it. Without it, the client's is used. If the client's electronic address is a Leitweg-ID (scheme 0204), its check digits are verified (ISO/IEC 7064 MOD 97-10) and one that fails responds 400.
`purchase_order`	`string`	The client's purchase order number (BT-13 of the European e-invoice).

curl -X POST https://cordhq.app/api/v1/facturas \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"cliente_id":"…","items":[{"descripcion":"…","cantidad":1,"precio_unitario":1}]}'

const created = await cord.invoices.create({
  "cliente_id": "…",
  "items": [
    {
      "descripcion": "…",
      "cantidad": 1,
      "precio_unitario": 1
    }
  ]
});

Response: data

id string Identifier (UUID).

GET`/api/v1/facturas/{id}`

Retrieve an invoicescope: read

curl https://cordhq.app/api/v1/facturas/ID \
  -H "Authorization: Bearer sk_test_..."

const item = await cord.invoices.retrieve('ID');

Response: data

`id`	`string`	Identifier (UUID).
`numero`	`string \| null`	Invoice number within its series.
`folio_fiscal`	`string \| null`	Identifier with the tax authority (the CFDI UUID in Mexico); null if it does not apply.
`cliente`	`string \| null`	Client the document is addressed to: the company name, or the details to create the client if it does not exist.
`estado`	`string`	draft, open, paid, void or uncollectible.
`estado_fiscal`	`string`	Issuance status: pending, issued, cancelled or error.
`pais`	`string`	ISO 3166-1 alpha-2 country code.
`tipo`	`string`	Document type: cfdi_40, cfdi_egreso, proforma, commercial_invoice, commercial_credit_note, verifactu_invoice or verifactu_credit_note.
`documento`	`"factura" \| "factura_proforma" \| "nota_credito" \| "nota_debito"`	How the document is titled. factura_proforma is a pro forma invoice: it is not an invoice and is not valid for tax purposes. It covers the proforma type and, in Spain, any document without a Verifactu record.
`moneda`	`string \| null`	ISO 4217 currency code.
`total`	`number`	Amount in the currency given by `moneda`.
`pagado`	`number`	Amount in the currency given by `moneda`.
`saldo`	`number`	Amount in the currency given by `moneda`.
`vence`	`string \| null`	ISO 8601 date.
`vencida`	`boolean`	true if the due date has passed with a balance due.
`cotizacion_id`	`string \| null`	ID of the related quote.
`creada`	`string \| null`	ISO 8601 date.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Read-only. Language the invoice was issued in: es, en, pt, fr or de. null while it is a draft.
`subtotal`	`number`	Amount in the currency given by `moneda`.
`impuestos`	`number`	Amount in the currency given by `moneda`.
`moneda_contable`	`string \| null`	ISO 4217 currency code.
`tipo_cambio`	`number \| null`	Exchange rate stated from the sales currency to the accounting currency; null if they are the same.
`total_contable`	`number \| null`	Total converted to the accounting currency.
`notas`	`string \| null`	Internal notes; the client does not see them.
`nota_credito_de`	`string \| null`	ID of the invoice this credit note corrects.
`emisor`	`any`	Tax details of the issuer.
`receptor`	`any`	Tax details of the client receiving the invoice.
`descuento`	`object \| null`	Document discount, applied before tax and spread across line items; null if there is none. subtotal is already net.
`conceptos`	`object[]`	Invoice line items with their tax.
`pagos`	`object[]`	Payments received.

POST`/api/v1/facturas/{id}`

Issue, send, void, record a payment or create a credit notescope: write

Field	Type	Description
`action` required	`"finalize" \| "send" \| "void" \| "payment" \| "credit_note"`	Action to run; each one requires the right prior status and is idempotent with Idempotency-Key.
`monto`	`number`	Amount in the currency given by moneda.
`moneda`	`string`	ISO 4217 currency of the amounts.
`metodo`	`string`	Payment method: transferencia, efectivo, tarjeta…
`referencia`	`string`	Reference of the payment or the provider.
`motivo`	`string`	Reason, written by a person.
`sin_comercio_exterior`	`boolean`	Mexico, when issuing (finalize): true confirms that a CFDI with goods for a client abroad is not a definitive export. Without it, that issuance responds 409 with the code comercio_exterior, because Cord does not generate the foreign trade complement.

curl -X POST https://cordhq.app/api/v1/facturas/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"finalize"}'

await cord.invoices.finalize('ID');

Response: data

id string Identifier (UUID).

Collections

GET`/api/v1/cobranza`

Accounts receivablescope: read

curl https://cordhq.app/api/v1/cobranza \
  -H "Authorization: Bearer sk_test_..."

const cartera = await cord.collections.retrieve();

Response: data

`resumen`	`any`	Totals at a glance.
`aging`	`any`	Receivables by age in four fixed buckets: vigente (not yet due), d30 (1–30 days overdue), d60 (31–60) and d60p (more than 60). Each one includes key, label, monto and n.
`items`	`any[]`	Line items.
`clientes`	`any`	Balance grouped by client.

Events

GET`/api/v1/events`

Event historyscope: readCursor pagination

Query parameters: limit, cursor, type, object_id

curl https://cordhq.app/api/v1/events \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.events.listAll()) {
  console.log(item.id);
}

Response: data[]

`id`	`string`	Identifier (UUID).
`type`	`string`	Event type, for example quote.approved.
`object`	`string`	Object type: quote, invoice, client, product, task, promise…
`object_id`	`string \| null`	ID of the object it refers to.
`data`	`object`	Content of the response or the event.
`actor`	`string \| null`	Who did it: user, api, mcp, client (the recipient of the public link) or system.
`created_at`	`string`	Creation date, ISO 8601.

Tasks

POST`/api/v1/tareas`

Create a taskscope: write

Field	Type	Description
`titulo` required	`string`	What needs to be done.
`due_date`	`string`	Due date, YYYY-MM-DD.
`cotizacion_id`	`string`	ID of the related quote.
`factura_id`	`string`	ID of the related invoice (the `id` from /facturas).

curl -X POST https://cordhq.app/api/v1/tareas \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"titulo":"…"}'

await cord.tasks.create({ titulo: 'Llamar a Acme' });

Response: data

id string Identifier (UUID).

Workflows

POST`/api/v1/workflows/{id}/invoke`

Run a "You run it" workflow on quotes or invoicesscope: write

Field	Type	Description
`objeto` required	`"quote" \| "invoice"`	Document type: quote or invoice; it must match the workflow trigger.
`ids` required	`string[]`	Identifiers (UUID) of the documents, from 1 to 50.

curl -X POST https://cordhq.app/api/v1/workflows/ID/invoke \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"objeto":"quote","ids":["…"]}'

Response: data

`documentos`	`number`	How many of the documents sent exist in the organization.
`corridas`	`number`	How many runs started: a document that does not meet the workflow filter or that already went in before does not count.

Webhooks

GET`/api/v1/webhooks`

Endpoints created by this keyscope: read

curl https://cordhq.app/api/v1/webhooks \
  -H "Authorization: Bearer sk_test_..."

const items = await cord.webhookEndpoints.list();

Response: data

`id`	`string`	Identifier (UUID).
`url`	`string`	HTTPS URL that receives the events.
`eventos`	`string[]`	List of events or event types. Empty = all.
`activo`	`boolean`	false if it is deactivated: it is kept but not used.
`created_at`	`string`	Creation date, ISO 8601.

POST`/api/v1/webhooks`

Create an endpoint (the secret is returned only once)scope: write

Field	Type	Description
`url` required	`string`	HTTPS URL that receives the events.
`eventos`	`string[]`	List of events or event types. Empty = all.

curl -X POST https://cordhq.app/api/v1/webhooks \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"…"}'

const created = await cord.webhookEndpoints.create({
  "url": "…"
});

Response: data

`id`	`string`	Identifier (UUID).
`url`	`string`	HTTPS URL that receives the events.
`eventos`	`string[]`	List of events or event types. Empty = all.
`activo`	`boolean`	false if it is deactivated: it is kept but not used.
`created_at`	`string`	Creation date, ISO 8601.
`secret`	`string`	Secret used to verify the signature. It is shown only once.

DELETE`/api/v1/webhooks/{id}`

Delete an endpointscope: write

curl -X DELETE https://cordhq.app/api/v1/webhooks/ID \
  -H "Authorization: Bearer sk_test_..."

await cord.webhookEndpoints.del('ID');

Response: data

id string Identifier (UUID).

Elements

GET`/api/v1/elements/config`

Configuration that Cord Elements rendersAccepts pk_scope: read

curl https://cordhq.app/api/v1/elements/config \
  -H "Authorization: Bearer sk_test_..."

const config = await cord.elements.config();

Response: data

`object`	`"elements_config"`	Object type: quote, invoice, client, product, task, promise…
`org`	`object`	Organization that owns the key.
`monedas`	`string[]`	Currencies the business offers when quoting.
`impuestos`	`object`	Taxes on the document, or the tax catalog.
`terminos`	`"contado" \| "net7" \| "net15" \| "net30" \| "net45" \| "net60" \| "net90"[]`	Payment terms: contado or net<N> (N days of credit: 7, 15, 30, 45, 60 or 90).
`terminos_default`	`"contado" \| "net7" \| "net15" \| "net30" \| "net45" \| "net60" \| "net90"`	Default payment terms.
`vigencia_dias_default`	`number`	Default validity, in days.
`fiscal`	`object`	Tax details.

POST`/api/v1/elements/ai-draft`

AI line items, streamed (text/event-stream)Accepts pk_scope: write

Field	Type	Description
`texto`	`string`	Free text of the order.
`archivo`	`string`	JPG, PNG or PDF, up to 4 MB.

curl -X POST https://cordhq.app/api/v1/elements/ai-draft \
  -H "Authorization: Bearer sk_test_..." \
  -F "texto=5 sacos de cemento y 2 de arena"

Responds text/event-stream with item, done and error events.

Test mode

POST`/api/v1/test_helpers/fiscal`

Force the outcome of the next issuancesk_test_ onlyscope: write

Field	Type	Description
`siguiente_resultado` required	`"exito" \| "pac_caido" \| "receptor_invalido" \| "certificado_vencido" \| "timbre_duplicado"`	Outcome of the next fiscal issuance in the sandbox.

curl -X POST https://cordhq.app/api/v1/test_helpers/fiscal \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"siguiente_resultado":"exito"}'

await cord.testHelpers.fiscal.setNextOutcome('pac_caido');

Response: data

siguiente_resultado string Outcome of the next fiscal issuance in the sandbox.

POST`/api/v1/test_helpers/cotizaciones/{id}`

Simulate a view or an expirationsk_test_ onlyscope: write

Field	Type	Description
`accion` required	`"vista" \| "vencer"`	What to simulate: vista (the client opens the link) or vencer (the quote expires).

curl -X POST https://cordhq.app/api/v1/test_helpers/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"accion":"vista"}'

await cord.testHelpers.quotes.expire('ID');

Response: data

id string Identifier (UUID).

POST`/api/v1/test_helpers/webhooks`

Trigger a webhooksk_test_ onlyscope: write

Field	Type	Description
`evento` required	`string`	Event type, for example quote.approved.
`objeto_id`	`string`	ID of a quote or invoice in the sandbox; without it, sample data is used.

curl -X POST https://cordhq.app/api/v1/test_helpers/webhooks \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"evento":"…"}'

await cord.testHelpers.webhooks.trigger('invoice.paid');

Response: data

`evento`	`string`	Event type, for example quote.approved.
`datos`	`"real" \| "ejemplo"`	real if the data of the given object was used; ejemplo if sample data was made up.

POST`/api/v1/test_helpers/listen`

Open a cord listen sessionsk_test_ onlyscope: write

Field	Type	Description
`eventos`	`string[]`	List of events or event types. Empty = all.

curl -X POST https://cordhq.app/api/v1/test_helpers/listen \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Response: data

`id`	`string`	Identifier (UUID).
`secret`	`string`	Secret used to verify the signature. It is shown only once.
`eventos`	`string[]`	List of events or event types. Empty = all.
`expira`	`string`	Expiration date, ISO 8601.

GET`/api/v1/test_helpers/listen/{id}`

Collect the session's eventssk_test_ onlyscope: write

curl https://cordhq.app/api/v1/test_helpers/listen/ID \
  -H "Authorization: Bearer sk_test_..."

Response: data

`event_id`	`string`	Event ID; deduplicate on it.
`evento`	`string`	Event type, for example quote.approved.
`body`	`string`	Raw body of the event; forward it unchanged so the signature verifies.
`headers`	`object`	Headers to forward as is, including the X-Cord-Signature-V1 signature.

DELETE`/api/v1/test_helpers/listen/{id}`

Close a cord listen sessionsk_test_ onlyscope: write

curl -X DELETE https://cordhq.app/api/v1/test_helpers/listen/ID \
  -H "Authorization: Bearer sk_test_..."

Response: data

id string Identifier (UUID).

Setup

POST`/api/v1/setup/plans`

Propose an account setup (a person approves it at review_url)scope: write

Field	Type	Description
`sitio`	`string`	The business's website, for example yourbusiness.com.
`descripcion`	`string`	Description of the business: industry, payment terms, taxes it charges or withholds.
`archivo`	`object`	Price list (Excel, CSV, PDF or photo) in base64, up to 3 MB.

curl -X POST https://cordhq.app/api/v1/setup/plans \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Response: data

`object`	`"setup_plan"`	Object type: quote, invoice, client, product, task, promise…
`id`	`string`	Identifier (UUID).
`estado`	`"generando" \| "propuesto" \| "aplicado" \| "descartado" \| "fallido"`	propuesto waits for a person to approve it at review_url.
`review_url`	`string`	Page where a signed-in person reviews and applies the proposal. The API never applies it.

GET`/api/v1/setup/plans/{id}`

Status of a setup proposalscope: read

curl https://cordhq.app/api/v1/setup/plans/ID \
  -H "Authorization: Bearer sk_test_..."

Response: data

`object`	`"setup_plan"`	Object type: quote, invoice, client, product, task, promise…
`id`	`string`	Identifier (UUID).
`estado`	`"generando" \| "propuesto" \| "aplicado" \| "descartado" \| "fallido"`	propuesto waits for a person to approve it at review_url.
`review_url`	`string`	Page where a signed-in person reviews and applies the proposal. The API never applies it.

Account

GET/api/v1/me

Quotes

GET/api/v1/cotizaciones

POST/api/v1/cotizaciones

GET/api/v1/cotizaciones/{id}

POST/api/v1/cotizaciones/{id}

DELETE/api/v1/cotizaciones/{id}

POST/api/v1/cotizaciones/ia

Clients

GET/api/v1/clientes

POST/api/v1/clientes

GET/api/v1/clientes/{id}

PATCH/api/v1/clientes/{id}

Products

GET/api/v1/productos

POST/api/v1/productos

Invoices

GET/api/v1/facturas

POST/api/v1/facturas

GET/api/v1/facturas/{id}

POST/api/v1/facturas/{id}

Collections

GET/api/v1/cobranza

Events

GET/api/v1/events

Tasks

POST/api/v1/tareas

Workflows

POST/api/v1/workflows/{id}/invoke

Webhooks

GET/api/v1/webhooks

POST/api/v1/webhooks

DELETE/api/v1/webhooks/{id}

Elements

GET/api/v1/elements/config

POST/api/v1/elements/ai-draft

Test mode

POST/api/v1/test_helpers/fiscal

POST/api/v1/test_helpers/cotizaciones/{id}

POST/api/v1/test_helpers/webhooks

POST/api/v1/test_helpers/listen

GET/api/v1/test_helpers/listen/{id}

DELETE/api/v1/test_helpers/listen/{id}

Setup

POST/api/v1/setup/plans

GET/api/v1/setup/plans/{id}

GET`/api/v1/me`

GET`/api/v1/cotizaciones`

POST`/api/v1/cotizaciones`

GET`/api/v1/cotizaciones/{id}`

POST`/api/v1/cotizaciones/{id}`

DELETE`/api/v1/cotizaciones/{id}`

POST`/api/v1/cotizaciones/ia`

GET`/api/v1/clientes`

POST`/api/v1/clientes`

GET`/api/v1/clientes/{id}`

PATCH`/api/v1/clientes/{id}`

GET`/api/v1/productos`

POST`/api/v1/productos`

GET`/api/v1/facturas`

POST`/api/v1/facturas`

GET`/api/v1/facturas/{id}`

POST`/api/v1/facturas/{id}`

GET`/api/v1/cobranza`

GET`/api/v1/events`

POST`/api/v1/tareas`

POST`/api/v1/workflows/{id}/invoke`

GET`/api/v1/webhooks`

POST`/api/v1/webhooks`

DELETE`/api/v1/webhooks/{id}`

GET`/api/v1/elements/config`

POST`/api/v1/elements/ai-draft`

POST`/api/v1/test_helpers/fiscal`

POST`/api/v1/test_helpers/cotizaciones/{id}`

POST`/api/v1/test_helpers/webhooks`

POST`/api/v1/test_helpers/listen`

GET`/api/v1/test_helpers/listen/{id}`

DELETE`/api/v1/test_helpers/listen/{id}`

POST`/api/v1/setup/plans`

GET`/api/v1/setup/plans/{id}`