List suppliers
Whoever issued your key's business a received document in its environment, withholdings aside (a customer issues those), one per RUC: the one you bought from most recently first, with what their latest document says of them.
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 <= 200q?stringA word of their name, or the start of their RUC.
1 <= length <= 100Fiscalbase-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.
A page of suppliers
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/suppliers'{
"object": "list",
"data": [
{
"object": "supplier",
"identification": "stringstrings",
"name": "string",
"regime": "general",
"special_taxpayer": true,
"document_count": 0,
"total": "string",
"last_issue_date": "2019-08-24"
}
],
"next_cursor": "string",
"prev_cursor": "string"
}Download a received document's XML GET
The SRI `autorizacion` with the signed document inside, as stored. `409` when its XML never arrived (listed only by a report, or out of the SRI's window).
Read an invoice from the SRI GET
Asks the SRI for an invoice addressed to anyone, including one whose annulment is pending, and reads it without storing it: enough to issue a withholding on it. A `test` key asks the SRI's testing service and a `live` key its real one; the access key must belong to the same environment. The SRI only answers for documents from the last 60 days. `sandbox` never asks it: its practice SRI answers for the practice business's received invoices (keyed `ambiente 1`), and any other key is not found. An answer may be kept for a minute (`Cache-Control`). To keep a document in your records, upload its XML or the SRI's report with `POST /v1/ec/imports`.