Skip to Content

How the SRI is answering

GET
/v1/ec/sri/status

Whether the SRI is slow to receive or decide your documents in the key's environment right now, so a client deciding whether to wait or retry knows. Read from your own documents in one pass; the SRI is never asked.

Authorization

headerAuthorizationBearer <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.

Header Parameters

Fiscalbase-Environment?string

The 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.

Value in"sandbox""test""live"
Fiscalbase-Business?string

The 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.

Formatuuid
Fiscalbase-Channel?string

Which 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.

Value in"api""mcp"
Fiscalbase-Agent?string

The 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.

Response Body

The SRI's state

application/json
  1. response
object*"sri_status"
Value in"sri_status"
environment*string
Value in"sandbox""test""live"
status*string

slow when one of your documents has waited more than 5 minutes for the SRI to receive it or more than 10 for its decision; ok otherwise. Judged by your own documents in the environment, not by asking the SRI.

Value in"ok""slow"
waiting_reception*integer

Your documents the SRI hasn't received yet (pending).

waiting_decision*integer

Your documents the SRI received and hasn't decided yet (submitted).

oldest_waiting_since*|

When the document that has waited longest started waiting; null when none waits.

Formatdate-time
Example Request
curl -X GET 'https://api.fiscalbase.io/v1/ec/sri/status'
Example Response
{
  "object": "sri_status",
  "environment": "sandbox",
  "status": "ok",
  "waiting_reception": 0,
  "waiting_decision": 0,
  "oldest_waiting_since": "2019-08-24T14:15:22Z"
}