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

# List Auditable Entities

Get the auditable entities with their associated data such as files, issues, risk scores, and users.

**Note**: Use the `url` property of a file in the `files` array to get entity files.

<Note>
  External Documentation

  To learn more, visit the [AuditBoard documentation](https://developer.auditboard.com/reference/get_entities).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter | Description                                                    |
  | --------- | -------------------------------------------------------------- |
  | Include   | Specify which optional data fields to include in the response. |
</div>

## Example Output

```json theme={"dark"}
{
  "auditable_entities": [
    {
      "id_string": "My Vendor! (uid: 150)",
      "custom_date1": null,
      "custom_date2": null,
      "custom_date3": null,
      "custom_date4": null,
      "effective_date": null,
      "prior_audit_final_report_date": null,
      "risk_next_audit_due_date": null,
      "regulatory_next_audit_due_date": null,
      "id": 150,
      "uid": "150",
      "name": "My Vendor!",
      "file_ids": [
        1878
      ],
          }
  ],
  "files": [
    {
      "viewable_link": null,
      "url": "https://<your-subdomain>.auditboardapp.com/soxhubuploads/soxhubuploads/7cfefc5c-f7b6-42ea-964f-5cc25e631043/foo?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=soxhub_minio_key%2F20230328%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20230328T190830Z&X-Amz-Expires=3600&X-Amz-Signature=04624d41ab55371dd05284fe4c3571b7833cee9e56043d2232b5fd7184799807&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3B%20filename%3D%22foo%22%3B%20filename%2A%3Dutf-8%27%27foo",
      "image_url": "",
      "id": 1878,
//...
    }
  ],
 "issues": [
    {
      "last_action_plan_due_date": null,
      "alias_reference_issue_id": null,
      "alias_controls_datum_id": null,
      "alias_compliance_assessment_item_id": null,
      "alias_ops_audit_item_id": null,
      "alias_test_id": null,
      "linkify_uid": "I#347",
      "remediation_owners": {
        "all": []
      },
      "identified_date": null,
      "custom_date1": null,
      "custom_date2": null,
      "custom_date3": null,
      "custom_date4": null,
      "external_planned_confirm_date": null,
      "external_confirm_date": null,
      "internal_audit_validation_date": null,
      "id": 347,
      "status": "Inactive",
      // ...
      "title": "My Issue for My Vendor",
      "description": "",
      // ...
      }
  ]
}
```

## Workflow Library Example

[List Auditable Entities with Auditboard and Send Results Via Email](https://library.blinkops.com/workflows/list-auditable-entities-with-auditboard-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-auditable-entities-with-auditboard-and-send-results-via-email/canvas" />
</div>