> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Decision Tools

> Lists the decision tools that are switched on. Tools are added and changed without notice, so read this list rather than hard-coding tool names. Not charged.

## Description

Lists the decision tools that are switched on, with what each one answers, who it's about, the
inputs it takes and an example question. Use a tool's `name` and `example` to build a
[Make a decision](https://docs.firmable.com/api-reference/endpoint/decisions-make.md) request.

The call is not charged. Tools are added and changed without notice, so read the list rather than
hard-coding tool names.

```bash theme={null}
curl "https://api.firmable.com/decisions" \
  -H "Authorization: Bearer fbl_your_key"
```

## Tool fields

| Field | What it is |
| - | - |
| `name` | The tool's name, sent as `tool` in a decision request. |
| `summary` | The question the tool answers. |
| `subject` | Who it's about: `company`, `person`, or `company or person`. |
| `input_schema` | A JSON Schema for the tool's `question`. Fields it doesn't list are rejected. |
| `example` | A valid `question` for the tool. |

A company is identified by `company_id` or `domain`, and a person by `person_id`, `linkedin_url` or
`work_email`. See [Decisions](https://docs.firmable.com/api-reference/decisions.md) for the full guide.

## Errors

| Status | Code | When |
| - | - | - |
| `401` | `unauthorized` | A missing or invalid API key |
| `403` | `forbidden` | The key can't use this endpoint |
| `429` | | Too many requests. Wait for the number of seconds in the `retry-after` header |
| `502` | `upstream_error` | The decision service is unavailable. Try again shortly |


## OpenAPI

````yaml GET /decisions
openapi: 3.0.1
info:
  title: Firmable API
  description: >-
    The Firmable API provides access to company and people data across multiple
    countries including Australia, New Zealand, Singapore, Malaysia, Indonesia,
    Philippines, Hong Kong, Japan, Vietnam, South Korea, Thailand, United
    States, and Canada. Use it to look up company profiles, retrieve contact
    information, and search for people by company, position, seniority, and
    department.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.firmable.com
security:
  - bearerAuth: []
paths:
  /decisions:
    get:
      description: >-
        Lists the decision tools that are switched on. Tools are added and
        changed without notice, so read this list rather than hard-coding tool
        names. Not charged.
      responses:
        '200':
          description: Decision tools
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecisionTools'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecisionError'
        '403':
          description: The key can't use this endpoint
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecisionError'
        '429':
          description: >-
            Too many requests. Wait for the number of seconds in the retry-after
            header
        '502':
          description: The decision service is unavailable. Try again shortly
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecisionError'
components:
  schemas:
    DecisionTools:
      type: object
      required:
        - tools
      properties:
        version:
          type: string
          description: The version of the tool list.
          example: '2026-11-06'
        tools:
          type: array
          items:
            $ref: '#/components/schemas/DecisionTool'
    DecisionError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: invalid_request
            message:
              type: string
              example: 'withReasoning: must be true or false'
            docs_url:
              type: string
              example: /decisions
        request_id:
          type: string
    DecisionTool:
      type: object
      properties:
        name:
          type: string
          description: The tool's name, sent as tool in a decision request.
          example: is_b2b
        summary:
          type: string
          description: The question the tool answers.
        subject:
          type: string
          description: Who the tool is about.
          enum:
            - company
            - person
            - company or person
          example: company
        input_schema:
          type: object
          description: >-
            A JSON Schema for the tool's question. Fields it doesn't list are
            rejected.
        example:
          type: object
          description: A valid question for the tool.
          example:
            company_id: f000002437529
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.