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

# POST /data-source/type — List Data Source Types

> Search and paginate the data source types (integrations) available in Data Hub, filtered by organization.

<Warning>
  Like [Variable List](/api-reference/query/variable-list) and [Monitored Entity List](/api-reference/query/monitored-entity-list), this is a `POST` request with a JSON body rather than a `GET` with query parameters.
</Warning>

<Note>
  Organization ids below are shown as the same 8-character placeholders already assigned on the [Organizations](/api-reference/query/organizations) page, matched by name — see the warning below about two ids in the source example that don't match any documented organization.
</Note>

## Endpoint

```text theme={null}
POST /data-source/type
```

## Query parameters

| Parameter  | Description                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `page`     | Page number to retrieve (1-indexed).                                                                                                                                                                                                                                                                                                                                                                |
| `per_page` | Number of results per page. [Variable List](/api-reference/query/variable-list#query-parameters) and [Monitored Entity List](/api-reference/query/monitored-entity-list#query-parameters) default this to `25` with a `100` maximum, and also accept `orderColumn`/`order` — whether the same defaults, maximum, and sort parameters apply here too isn't confirmed for this endpoint specifically. |

## Request body

| Field           | Type            | Description                                                                                                                                               |
| --------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `organizations` | array of string | Organization ids to filter by — see [Organizations](/api-reference/query/organizations) and [Get Filters](/api-reference/query/data-source-type-filters). |

## Example request

```bash theme={null}
curl -X POST "https://api.communityhub.cloud/dh/public/v1/data-source/type?page=1&per_page=25" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "organizations": [
      "3f8c1a02", "9d2e77b4", "6a1f0c9d", "b57e2f81", "e4913dc6",
      "0c8a44f7", "77b0e2ad", "d3f6109b", "1a9e5c34", "050fd8ab",
      "8066f723", "f206b8e1", "5e0d3a72"
    ]
  }'
```

<Warning>
  **Open — not fully decided:** the source example for this request body included 13 organization ids. Eleven map cleanly to the organizations documented on the [Organizations](/api-reference/query/organizations) page (shown above in that order); the remaining two (placeholders `050fd8ab` and `8066f723` here) don't correspond to any of the 11 organizations documented there. This could mean there are more than 11 organizations and the Organizations page is incomplete, or it could be an error in the source example — flagging rather than guessing which.
</Warning>

## Response shape

Unlike [Variable List](/api-reference/query/variable-list#response-shape) and [Monitored Entity List](/api-reference/query/monitored-entity-list#response-shape), the response here is a **bare array** — not wrapped in a `{ data, defaultOrderColumn, pagination }` object:

```json theme={null}
[
  {
    "type": "obvius",
    "instances": 140,
    "image": "https://communityhubstorage.cloud/ch-data-hub/integrations/obvius.png",
    "name": "Obvius",
    "sourcesWithDataErrors": 0,
    "disconnectedSources": 127
  },
  {
    "type": "onedrive-csv",
    "instances": 39,
    "image": "https://communityhubstorage.cloud/ch-data-hub/integrations/onedrive.svg",
    "name": "OneDrive",
    "sourcesWithDataErrors": 0,
    "disconnectedSources": 11
  },
  {
    "type": "csv",
    "instances": 24,
    "image": "https://communityhubstorage.cloud/ch-data-hub/integrations/csv.jpg",
    "name": "CSV",
    "sourcesWithDataErrors": 0,
    "disconnectedSources": 14
  }
]
```

### Data source type object

| Field                   | Type    | Description                                                                                                                                                                 |
| ----------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`                  | string  | Machine-readable key for the integration (for example `obvius`, `onedrive-csv`, `csv`). `onedrive-csv` corresponds to the [OneDrive](/guides/sources/onedrive) data source. |
| `name`                  | string  | Display name.                                                                                                                                                               |
| `instances`             | integer | Number of configured instances of this integration type across the organization(s) in the request.                                                                          |
| `image`                 | string  | URL to this integration type's icon/logo.                                                                                                                                   |
| `sourcesWithDataErrors` | integer | Count of this type's data sources currently reporting data errors.                                                                                                          |
| `disconnectedSources`   | integer | Count of this type's data sources currently disconnected.                                                                                                                   |

<Warning>
  **Open — not fully decided, and a few things to flag:**

  * This response is a bare array with no pagination metadata at all — no `total_records`, `current_page`, and so on. Whether `page`/`per_page` genuinely paginate this endpoint, and how a caller would know if more results exist beyond the returned array, isn't documented.
  * None of the three types in this example (`obvius`, `onedrive-csv`, `csv`) appear in the 14 supported types listed below, and none of those 14 appear in this example. That's not necessarily a contradiction — this may just be one page of a larger set — but it means the note below shouldn't be treated as this endpoint's full/confirmed output; treat the two lists as separate, only partially-overlapping pieces of information until reconciled.
  * Whether `sourcesWithDataErrors` and `disconnectedSources` are mutually exclusive counts, or a source can count toward both, isn't documented.
</Warning>

<Note>
  Data Hub currently supports the following data source types (integrations):

  * [BuildingOS](/guides/sources/buildingos)
  * Derived — see [Derived Variables](/guides/transforming-data)
  * [JACE](/guides/sources/jace)
  * [OpenWeatherMap](/guides/sources/openweathermap)
  * Freeboard Technology
  * [GLOS](/guides/sources/glos)
  * USGS
  * [Motion](/guides/sources/motion)
  * Clean in CLE
  * Atrius CSV
  * Atrius XML
  * Atrius Siemens Apogee
  * [AirNow](/guides/sources/airnow)
  * Atrius Enphase API-V2

  Types without a link aren't documented elsewhere on this site yet. See [Connecting Data Sources](/guides/connecting-sources) for the general setup guide and per-source documentation-status legend.
</Note>

See [Get Filters](/api-reference/query/data-source-type-filters) to discover valid `organizations` values before calling this endpoint, and [Instance Filters](/api-reference/query/data-source-instance-filters) for the parallel filter-discovery endpoint for individual data source instances.