List businesses
With a key, its own business alone: a key acts for one. With a person's session, the organization's practice and live businesses, each with its kind.
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 <= 200kind?stringOnly the businesses of this kind: sandbox ones issue with a sandbox key, live ones with a test or live key. Without it, all of them.
"sandbox""live"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 businesses
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/businesses'{
"object": "list",
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"object": "business",
"kind": "sandbox",
"country": "ec",
"ruc": "string",
"legal_name": "string",
"trade_name": "string",
"head_office_address": "string",
"head_office_phone": "string",
"head_office_email": "string",
"reply_to_email": "string",
"footer_legend": "string",
"keeps_accounting": true,
"regime": "general",
"special_taxpayer_resolution": "string",
"withholding_agent_resolution": "string",
"large_taxpayer_resolution": "string",
"certificate": {
"holder": "string",
"holder_identification": "string",
"holder_identification_type": "cedula",
"kind": "natural_person",
"issuer_name": "string",
"subject": "string",
"issuer": "string",
"serial_number": "string",
"valid_from": "2019-08-24T14:15:22Z",
"valid_until": "2019-08-24T14:15:22Z"
},
"issuing": {
"allowed": true,
"lock": {
"code": "plan_required",
"message": "string",
"canceled": true,
"trial_ended": true
},
"state": "off",
"active_since": "2019-08-24T14:15:22Z"
},
"portal": {
"brand_color": "string",
"title_font": "sora",
"corners": "square",
"layout": "split",
"cover": "brand",
"cover_url": "http://example.com",
"heading": "string",
"lead": "string",
"tagline": "string",
"top_bar": "white",
"whatsapp": "string",
"website": "string"
},
"logo": {
"url": "http://example.com",
"content_type": "image/png",
"size": 0
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"next_cursor": "string",
"prev_cursor": "string"
}Issuing and its activation GET
Where a `live` business's issuing stands and what must be met before it is activated in `live`, with what to do in each case: a valid certificate, an emission point in `live` with its addresses, and an invoice authorized in `test`. It keeps its received documents in `live` whatever this says; only issuing waits for the activation, which a person makes from the console, and `business.issuing_updated` tells when the state or the lock moves. A `sandbox` business always issues: it answers `active`, `ready` with no checks.
Get a business GET
The business with its `kind` and its current certificate, if it has one. To find out what it still needs before issuing in `live`, use `GET /v1/ec/businesses/{id}/issuing`.