---
title: "A company's calibrated intent score"
method: GET
path: "/v1/companies/{company_id}/intent"
---

# A company's calibrated intent score

`GET /v1/companies/{company_id}/intent`

## Request

- Base URL: `https://api.reqbeat.com`
- URL: `https://api.reqbeat.com/v1/companies/{company_id}/intent`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The calibrated-intent score + coverage meter for `company_id` --
computed live off every customer's submitted outcome labels. `score` is
`None` below the coverage-gating minimum (never a fabricated number).

Requires the `read` scope.

## Path parameters

- `company_id` integer, required: The plane's company id -- returned as `company_id` by /v1/reqs/search and by every company motion response.

## Response `200`

Successful Response

- CalibratedIntentResponse
  - `company_id` integer, required
  - `positive_count` integer, required
  - `negative_count` integer, required
  - `label_count` integer, required
  - `coverage` number, required
  - `score` number, nullable, required

## Other responses

- `401`: No API key was sent.
- `403`: The presented key is invalid or revoked, or (see `x-required-scope` on this operation) it does not carry the scope this operation requires.
- `422`: Validation Error

---

[API](https://skmtc.dev/reqbeat/apis/reqbeat-api.md) · [All operations](https://skmtc.dev/reqbeat/apis/reqbeat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqbeat/apis/reqbeat-api/revisions/4758e5957e8c?raw)