> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

# Signal object

> Lists the contents of a signal object.

This page describes the `signal` object, which represents a risk score and assessment for a business. Signals provide a numerical score from 0 to 1 along with reason codes that explain the factors contributing to the score.

**`Example JSON response`**

```json title="Example JSON response"
{
  "object": "signal",
  "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
  "name": "Acme Corp",
  "tin": "12-3456789",
  "external_id": "customer-123",
  "model_slug": "default",
  "score": 0.85,
  "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
  "batch_id": null,
  "requester": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "api_key",
    "name": "Production API Key"
  },
  "reasons": [
    {
      "category": "identification",
      "group": "customer_information",
      "description": "The submitted tax ID belongs to the business",
      "code": "I102",
      "importance": 0.25
    },
    {
      "category": "verification",
      "group": "government_filings",
      "description": "The business is registered in multiple states",
      "code": "V101",
      "importance": 0.20
    }
  ],
  "addresses": ["2180 Bryant St Ste 210, San Francisco, CA 94110"],
  "people": ["John Smith", "Jane Doe"],
  "created_at": "2024-01-30T23:49:01.100Z"
}
```

## Signal attributes

| Attribute               | Type                  | Description                                                                                                    |
| ----------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------- |
| `object`                | string                | The object type. Always `signal`.                                                                              |
| `id`                    | string (uuid)         | The unique identifier for the signal.                                                                          |
| `name`                  | string                | The business name associated with this signal.                                                                 |
| `tin`                   | string \| null        | The Tax Identification Number if provided.                                                                     |
| `external_id`           | string \| null        | An optional external identifier you provided when creating the signal request.                                 |
| `model_slug`            | string                | The scoring model used to generate this signal.                                                                |
| `score`                 | float \| null         | The risk score from 0.0 (highest risk) to 1.0 (lowest risk). May be null if the score could not be calculated. |
| `business_id`           | string (uuid) \| null | The unique identifier of the associated business, if one was created.                                          |
| `batch_id`              | string (uuid) \| null | The unique identifier of the batch, if this signal was part of a batch request.                                |
| `requester`             | object                | Information about who requested the signal.                                                                    |
| `requester.id`          | string (uuid)         | The unique identifier of the requester.                                                                        |
| `requester.type`        | string                | The type of requester (for example, `api_key`, `user`).                                                        |
| `requester.name`        | string                | The name of the requester.                                                                                     |
| `reasons`               | object\[]             | An array of reason codes explaining the score.                                                                 |
| `reasons[].category`    | string                | The category of the reason. Possible values: `identification`, `verification`, `evaluation`.                   |
| `reasons[].group`       | string                | The group or area this reason pertains to.                                                                     |
| `reasons[].description` | string                | A human-readable description of the reason.                                                                    |
| `reasons[].code`        | string                | The reason code identifier.                                                                                    |
| `reasons[].importance`  | float                 | The relative importance of this reason in the overall score.                                                   |
| `addresses`             | string\[]             | List of addresses associated with the business.                                                                |
| `people`                | string\[]             | List of people associated with the business.                                                                   |
| `created_at`            | timestamp             | The timestamp when the signal was created.                                                                     |

## Reason categories

| Category         | Description                                                                |
| ---------------- | -------------------------------------------------------------------------- |
| `identification` | Reasons related to identifying and finding the business in public records. |
| `verification`   | Reasons related to verifying submitted information against found records.  |
| `evaluation`     | Reasons related to evaluating risk factors and business characteristics.   |

## Reason codes

Each signal includes one or more reason codes that explain the score. Reason codes are prefixed by their category: `I` for identification, `V` for verification, and `E` for evaluation.

For the complete list of reason codes and their descriptions, see [Reason codes](/accelerate-onboarding/reason-codes).

> **Get a demo**
>
> Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.