> 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.

# Policy result object

> Lists the contents of a policy result object.

This page describes the `policy_result` object, which represents the outcome of evaluating a business against a policy or ruleset. Policy results contain the overall decision, matched conditions, and individual action results.

**`Example JSON response`**

```json title="Example JSON response"
{
  "object": "policy_result",
  "id": "f074244d-5cf3-4703-950a-73a7d54ee555",
  "result": "approved",
  "name": "Standard Verification Policy",
  "matched": "all_conditions",
  "executed": true,
  "type_of": "business_verification",
  "business_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
  "owner_id": "b3638510-87ec-425e-bdaa-ad6e48dec871",
  "owner_type": "Business",
  "details": {
    "conditions_evaluated": 5,
    "conditions_passed": 5
  },
  "policy_action_results": [
    {
      "object": "policy_action_result",
      "id": "action-123",
      "action_type": "verify_tin",
      "result": "passed",
      "details": {
        "tin_verified": true,
        "name_match": true
      }
    },
    {
      "object": "policy_action_result",
      "id": "action-124",
      "action_type": "check_registration",
      "result": "passed",
      "details": {
        "status": "active"
      }
    }
  ],
  "created_at": "2024-01-30T23:49:01.100Z"
}
```

## Policy result attributes

| Attribute               | Type                  | Description                                            |
| ----------------------- | --------------------- | ------------------------------------------------------ |
| `object`                | string                | The object type. Always `policy_result`.               |
| `id`                    | string                | The unique identifier for the policy result.           |
| `result`                | string                | The overall outcome of the policy evaluation.          |
| `name`                  | string \| null        | The name of the policy that was evaluated.             |
| `matched`               | string \| null        | Indicates which conditions were matched.               |
| `executed`              | boolean               | Whether the policy was fully executed.                 |
| `type_of`               | string                | The type of policy result.                             |
| `business_id`           | string                | The unique identifier of the evaluated business.       |
| `owner_id`              | string                | The polymorphic owner ID.                              |
| `owner_type`            | string                | The polymorphic owner type.                            |
| `details`               | object                | Additional details about the policy evaluation.        |
| `policy_action_results` | PolicyActionResult\[] | An array of individual action results from the policy. |
| `created_at`            | timestamp             | The timestamp when the policy result was created.      |

## Policy action result attributes

Each action within a policy produces its own result, captured in the `policy_action_results` array.

| Attribute     | Type   | Description                                     |
| ------------- | ------ | ----------------------------------------------- |
| `object`      | string | The object type. Always `policy_action_result`. |
| `id`          | string | The unique identifier for the action result.    |
| `action_type` | string | The type of action that was evaluated.          |
| `result`      | string | The outcome of the individual action.           |
| `details`     | object | Additional details specific to the action type. |

## Common result values

| Result     | Description                                                         |
| ---------- | ------------------------------------------------------------------- |
| `approved` | The business passed all policy conditions and was approved.         |
| `rejected` | The business failed one or more policy conditions and was rejected. |
| `review`   | The business requires manual review before a final decision.        |
| `pending`  | The policy evaluation is still in progress.                         |

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