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

# API quickstart

> Sense from your own product or backend.

The IBF API is available under an Atlas engagement. See [Atlas quickstart](/guides/get-started/quickstart-atlas) to open access.

<Steps>
  <Step title="Get a key">
    Once your Atlas tenant is provisioned, your API key is in **Atlas > API Dashboard**.
  </Step>

  <Step title="Send your first sense call">
    ```bash theme={null}
    curl -X POST https://ibf.blankstate.ai/api/v1/sense \
      -H "Authorization: Bearer $BKS_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "content": "I understand this has been a difficult quarter. Let me walk you through exactly what happened.",
        "modality": "text",
        "protocols": ["empathy"],
        "actantId": "user_001"
      }'
    ```
  </Step>

  <Step title="Read the response">
    ```json theme={null}
    {
      "protocol": "empathy",
      "score": 0.74,
      "fidelity": 0.88,
      "metamarkers": [
        {
          "nuance": "acknowledges-emotional-state",
          "dimension": "B",
          "score": 0.81,
          "fidelity": 0.91,
          "segment": {
            "start": 0,
            "end": 53,
            "text": "I understand this has been a difficult quarter."
          }
        }
      ]
    }
    ```
  </Step>
</Steps>

## Run a Blueprint

Pass a Blueprint id to run a full sensing configuration in one call.

```bash theme={null}
curl -X POST https://ibf.blankstate.ai/api/v1/sense \
  -H "Authorization: Bearer $BKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "...",
    "modality": "text",
    "blueprint": "advisory-quality",
    "actantId": "user_001"
  }'
```

## Next

* [TypeScript SDK](/sdks/typescript): typed client
* [CLI](/sdks/cli): shell access
* [MCP](/sdks/mcp): agent-native sensing
* [Protocols reference](/guides/concepts/protocols): how Protocols work
* [ICS billing](/guides/concepts/ics): how billing accrues