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

# GET /data-source/instance-filters — Data Source Instance Filter Options

> Fetch the filter facets (organization, error type, status) used to filter the data source instance listing.

<Note>
  Ids below reuse the same convention as the other filter-discovery endpoints on this site: organization ids are shown as the same 8-character placeholders already assigned on the [Organizations](/api-reference/query/organizations) page, matched by name. `errorType` and `status` are catalog-style string enums and are kept as given.
</Note>

## Endpoint

```text theme={null}
GET /data-source/instance-filters
```

Returns the filter facets used to filter the data source **instance** listing — by organization, error type, and status. This is a different resource from [data source type](/api-reference/query/data-source-type-list): a "type" is the integration (Obvius, CSV, OneDrive, and so on), an "instance" is a specific configured connection of that type. The instance-listing endpoint these facets feed is documented at [Instance List](/api-reference/query/data-source-instance-list).

## Parameters

| Parameter | Description                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `orgIds`  | One or more organization [`id`](/api-reference/query/organizations) values to scope the returned filters to. Inferred from the pattern of every other filter-discovery endpoint on this site ([Filter Options](/api-reference/query/variable-filters), [Filter For List](/api-reference/query/monitored-entity-filters), [Get Filters](/api-reference/query/data-source-type-filters)) — not independently confirmed for this specific endpoint. |

## Example request

```bash theme={null}
curl "https://api.communityhub.cloud/dh/public/v1/data-source/instance-filters?orgIds=0c8a44f7" \
  -H "Authorization: Bearer <token>"
```

## Response shape

The response is a tree of facet groups — `organizations`, `errorType`, and `status`:

```json theme={null}
[
  {
    "id": "organizations",
    "label": "Organizations",
    "children": [
      { "id": "3f8c1a02", "label": "City of Cleveland" },
      { "id": "9d2e77b4", "label": "City of Oberlin" },
      { "id": "6a1f0c9d", "label": "City of Oberlin (Private Organizations)" },
      { "id": "b57e2f81", "label": "Cleveland Foundation" },
      { "id": "e4913dc6", "label": "Great Lakes Science Center" },
      { "id": "0c8a44f7", "label": "Oberlin College" },
      { "id": "77b0e2ad", "label": "Oberlin Public Library" },
      { "id": "d3f6109b", "label": "Oberlin Schools" },
      { "id": "1a9e5c34", "label": "Sustainable Community Associates" },
      { "id": "f206b8e1", "label": "Toledo Public Schools" },
      { "id": "5e0d3a72", "label": "University of Washington Bothell" }
    ]
  },
  {
    "id": "errorType",
    "label": "Errors",
    "children": [
      { "id": "fileError", "label": "File Error" },
      { "id": "dataError", "label": "Data Error" },
      { "id": "connectionError", "label": "Connection Error" }
    ]
  },
  {
    "id": "status",
    "label": "Status",
    "children": [
      { "id": "enabled", "label": "Enabled" },
      { "id": "disabled", "label": "Disabled" }
    ]
  }
]
```

### Facet groups returned

| Facet `id`      | Label         | Notes                                                                                                                                                                                                                                                                                                                                                              |
| --------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `organizations` | Organizations | Same ids as [Organizations](/api-reference/query/organizations). Labeled `"Organizations"` (plural), matching [Get Filters](/api-reference/query/data-source-type-filters) rather than the `"Organization"` (singular) label used on [Filter Options](/api-reference/query/variable-filters) and [Filter For List](/api-reference/query/monitored-entity-filters). |
| `errorType`     | Errors        | Fixed set of three error categories — file, data, and connection errors.                                                                                                                                                                                                                                                                                           |
| `status`        | Status        | Only `enabled`/`disabled` here — unlike the `status` facet on [Filter Options](/api-reference/query/variable-filters), which also includes `historical` for variables. Instances apparently don't have an equivalent historical state, or it simply wasn't included in this example — not confirmed either way.                                                    |

<Warning>
  **Open — not fully decided:**

  * Whether `orgIds` is really the query parameter (inferred from every sibling filter endpoint, not confirmed here specifically), and its multi-value encoding.
  * Whether `status` for instances really excludes a historical-equivalent state, or this example is just incomplete.
</Warning>

See [Organizations](/api-reference/query/organizations) for valid `orgIds` values, and [Type Listing](/api-reference/query/data-source-type-list) for the parallel, already-documented type-level listing endpoint.