---
title: "List policy results for a business"
method: GET
path: "/v1/businesses/{business_id}/policy_results"
tags: ["policyResults"]
---

# List policy results for a business

`GET /v1/businesses/{business_id}/policy_results`

## Request

- Base URL: `https://api.middesk.com`
- URL: `https://api.middesk.com/v1/businesses/{business_id}/policy_results`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/middesk/apis/middesk-api/docs/v1/businesses/:business_id/policy_results/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns policy results for enabled policy versions only

## Path parameters

- `business_id` string, required

## Response `200`

multiple policy results with different versions

- PolicyResultsList
  - `object` string, required
  - `data` PolicyResult[], required
    - `object` string
    - `id` string: Policy result ID
    - `result` string: Policy result outcome
    - `created_at` string: Creation timestamp
    - `matched` string, nullable: Match status
    - `executed` boolean: Execution status
    - `name` string, nullable: Policy name
    - `details` object: Additional details
    - `owner_id` string: Owner ID
    - `owner_type` string: Owner type
    - `business_id` string: Business ID
    - `type_of` string: Type of policy result
    - `policy_action_results` PolicyActionResult[]
      - `object` string
      - `id` string: Policy action result ID
      - `details` object: Action details
      - `executed` boolean: Execution status
      - `policy_action` PolicyActionResultPolicyAction
        - `id` string: Policy action ID
        - `action_type` string: Type of action
        - `options` object: Action options
        - `policy_version_id` string: Policy version ID
  - `url` string: API endpoint URL

## Other responses

- `404`: business not found

## Changes

- **2026-09-17** `4c9cd4e834ba`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `bearer_auth` was added to the API
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `listBusinessPolicyResults` removed and replaced with `policyResults_listBusinessPolicyResults`
- **2026-09-03** `ac0d9be94846`: 1 info
  - added the optional property `errors/items/parameter` to the response with the `404` status

[Operation history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/businesses/:business_id/policy_results/get.md)

---

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