# Introducing Firmable Decisions

> Ask a question about a company and get a decision, not a data dump. Every answer comes with how sure we are, the reason and the evidence.

- Authors: The Firmable team
- Published: 11 November 2026
- Category: Product releases
- Tags: decisions, api, agents
- Web page: https://developer.firmable.ai/blog/introducing-firmable-decisions

---
Your agent doesn't need fifty fields to answer a question about a company. It needs an answer it can act on. Firmable Decisions gives it one, on the same key as the Data API and MCP.

## Every answer has the same four parts

- **Decision.** Yes, no or unknown.
- **Confidence.** How sure we are. Set a floor and act above it.
- **Reason.** One sentence a person can check.
- **Evidence.** The deciding fact, its source and date, and what would change the answer.

Because every answer comes back in the same shape, your agent can branch on it and a person can review it later.

## What it looks like

Ask whether a company's head office is in Singapore, with reasoning turned on, and the answer comes back like this:

```json
{
  "tool": "is_located_in",
  "result": {
    "decision": "yes",
    "confidence": 1,
    "details": { "location_checked": "head office", "location_held": ["SG"] },
    "data_as_of": "2026-11-11",
    "reasoning": {
      "reason": "It has its head office in SG.",
      "source": "Firmable company data",
      "date": "2026-11-11",
      "would_change_if": []
    }
  }
}
```

> **Set a confidence floor**
> Act automatically above the floor you choose, and send anything below it to a person.

- [Get your free API key](https://platform.firmable.com/sign-up)
- [Read the docs](https://docs.firmable.com/api-reference/overview)
