List the establishments
The establishments of your key's business, each with its name, its address and its logo. An establishment exists once a series was opened at its code.
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 <= 200Fiscalbase-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 establishments
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/establishments'{
"object": "list",
"data": [
{
"object": "establishment",
"business_id": "f59fcbb7-848d-4242-af07-a8bb7e3ab37c",
"code": "string",
"name": "string",
"address": "string",
"logo": {
"url": "http://example.com",
"content_type": "image/png",
"size": 0
},
"effective_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"
}Verify a certificate without saving it POST
Runs the same checks as the upload: the password opens the file, it belongs to the business, its issuer is an accredited certification authority and it is valid. It saves nothing. It responds with what the certificate says; if anything fails, `422` with the reason in `errors[].code` of the `certificate` field.
Retrieve an establishment GET
Siguiente