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

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 page, matched by name. errorType and status are catalog-style string enums and are kept as given.

Endpoint

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: a “type” is the integration (Obvius, CSV, OneDrive, and so on), an “instance” is a specific configured connection of that type. No instance-listing endpoint itself has been documented yet — only this filter-discovery endpoint has been provided so far, the same situation Get Filters was in before Type Listing existed.

Parameters

Parameter	Description
`orgIds`	One or more organization `id` values to scope the returned filters to. Inferred from the pattern of every other filter-discovery endpoint on this site (Filter Options, Filter For List, Get Filters) — not independently confirmed for this specific endpoint.

Example request

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:

[
  {
    "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 `id`	Label	Notes
`organizations`	Organizations	Same ids as Organizations. Labeled `"Organizations"` (plural), matching Get Filters rather than the `"Organization"` (singular) label used on Filter Options and Filter For List.
`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, 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.

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.
No data source instance listing endpoint has been documented yet, so it isn’t confirmed how these facet ids get sent back as filters (though the pattern established by Type Listing and Monitored Entity List suggests a POST /data-source/instance-style endpoint accepting organizations, errorType, and status arrays is likely).
Whether status for instances really excludes a historical-equivalent state, or this example is just incomplete.

See Organizations for valid orgIds values, and Type Listing for the parallel, already-documented type-level listing endpoint.

Overview

Data Ingestion (Not Available)

Retrieving Data

Webhooks (Not Available)

Sample Code (No SDKs)

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

Endpoint

Parameters

Example request

Response shape

Facet groups returned

​Endpoint

​Parameters

​Example request

​Response shape

​Facet groups returned

Endpoint

Parameters

Example request

Response shape

Facet groups returned