List the series
Every series of your key's business in its environment, whoever issues on it: the series Fiscalbase hands numbers from, and the ones imports and brought-in documents showed other systems use, each with the last number seen, this month's documents and its gaps.
AuthorizationBearer <token>Your API key, which acts for the one business it was created for: fb_live_… keys work at api.fiscalbase.io and issue in live, and fb_sandbox_… keys work at api-sandbox.fiscalbase.io and issue in sandbox, on the simulated SRI. A key sent to the other host is refused with api_key_wrong_host, which names its host.
limit?integerHow many per page, from 1 to 100.
1 <= value <= 10020cursor?stringThe next_cursor or prev_cursor of a previous response. Without a cursor, the first page.
length <= 200issued_by?string"fiscalbase""facturador""other"type?string"invoice""credit_note""debit_note""withholding""delivery_note""purchase_settlement"establishment?string^\d{3}$has_gaps?stringOnly those with (true) or without (false) gaps.
"true""false"updated_at[gte]?stringOnly what changed at or after this moment, ISO 8601 with its offset: poll with the time of your last read to get what changed since.
date-timeFiscalbase-Environment?stringThe environment the call acts in. Required with a person's session; a key's own environment is the one that counts, so a key may leave it out, and naming another is 422 environment_mismatch.
"sandbox""test""live"Fiscalbase-Business?stringThe business the call acts for. With a person's session, the one the call is about (without it, a call about one business is 422 business_required and a list covers every business of the organization); a key acts for its own, so naming another is 422 business_mismatch.
uuidFiscalbase-Channel?stringWhich of Fiscalbase's own integrations a key's call comes from, recorded as the channel of the documents it issues: a record, not a permission. Without it, api. A person's call is always console.
"api""mcp"Fiscalbase-Agent?stringThe AI agent a key's call comes from, as its client names itself (the MCP server sets it); recorded with the request and shown in the console's request log.
The series
application/json- response
object*"list""list"data*array<>next_cursor*|The next page (older); null if there are no more.
prev_cursor*|The previous page (newer); null on the first.
curl -X GET 'https://api.fiscalbase.io/v1/ec/series'{
"object": "list",
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"object": "series",
"business_id": "f59fcbb7-848d-4242-af07-a8bb7e3ab37c",
"environment": "sandbox",
"type": "invoice",
"establishment": "string",
"emission_point": "string",
"establishment_address": "string",
"establishment_name": "string",
"emission_point_name": "string",
"issued_by": "fiscalbase",
"active": true,
"next_number": 1,
"last_number_seen": 0,
"last_seen_on": "2019-08-24",
"seen_this_month": 0,
"issued_today": 0,
"gaps": {
"count": 0,
"oldest_missing": 0
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"next_cursor": "string",
"prev_cursor": "string"
}Remove an establishment's logo DELETE
The establishment goes back to inheriting the business's logo.
Open a series POST
Opens a Fiscalbase series in your key's environment. Outside `sandbox`, the establishment must be listed as open for the RUC in the SRI registry; its address comes from there. One already there is `409 series_exists`, with its `series_id`. A punto another system used in the last 24 months is `409 series_used_elsewhere`, with `suggested_establishment` and `suggested_emission_point`, and the other system's `series_id` when its series of the type is there: take that one over with `POST /v1/ec/series/{id}/continue`. Send an `Idempotency-Key` to retry safely.