Export received documents
What your system books from the received documents that match the list's filters (an issue-date range, for one): recibidos.csv, or recibidos-<from>-<to>.csv with the days the range names (UTF-8 with a byte order mark: access_key, type, number, issue_date, issuer_ruc, issuer_name, subtotal, tax, total, sri_status, xml, withholding_number), alone or, with format=zip, beside each XML kept, under xml/, streamed as it is built. withholding_number is the withholding your business issued over it. Up to 10000 documents; more is 422 export_too_large.
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.
type?|array<>Only this family; repeat it for several.
access_key?stringThe one with these 49 digits.
^\d{49}$issue_date[gte]?stringOnly what was issued on or after this day.
dateissue_date[lte]?stringOnly what was issued on or before this day.
dateverification?|array<>xml_status?|array<>needs_review?stringtrue: only what waits for a person (no XML yet, or unconfirmed); false: only what doesn't.
"true""false"issuer?stringOnly what this supplier's RUC issued.
^\d{13}$q?stringWords of the issuer's name or of the document number, or the start of the issuer's RUC; each word must be found.
1 <= length <= 100updated_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-timeformat?stringcsv, the rows alone; zip, the same CSV and each document's XML under xml/.
"csv""csv""zip"Fiscalbase-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 CSV, or the ZIP
response?stringcurl -X GET 'https://api.fiscalbase.io/v1/ec/received-documents/export'"string"List received documents GET
The documents addressed to your key's business in its environment, from newest to oldest: what its suppliers invoiced and the withholdings its customers issued to it, whichever way they arrived. Never in the recipient portal.
Retrieve a received document GET
One of your received documents, as stored. To read an invoice from the SRI without storing it, `GET /v1/ec/sri/invoices/{access_key}`.