# Search data sources with specific item IDs

POST /v3/data-sources/search

This endpoint retrieves all the data sources in the account with their labels.

Endpoint: POST /v3/data-sources/search
Security: API_Key

## Query parameters:

  - `page` (integer)
    Number of results page of an endpoint with paginated results

  - `pageSize` (integer)

  - `sortBy` (string)
    Enum: "itemName", "itemType", "lastRun"

  - `sortDesc` (boolean)
    Controls sorting order

## Request fields (application/json):

  - `itemName` (string)
    filter the items by a given name

  - `labelIds` (array)
    filter the items by label ids

  - `itemIds` (array)
    filter the items by IDs (itemName & labelIds are ignored)

  - `itemType` (string)
    Type of data source item.
    Enum: "audit", "web-journey"

  - `withRuns` (boolean)
    If true - response includes only data sources with at least one run. If false - only those without runs. All if not set.

## Response 200 fields (application/json):

  - `metadata` (object, required)
    Common metadata for iterable

  - `metadata.pagination` (object, required)

  - `metadata.pagination.totalCount` (integer, required)
    Total number of items available from all result pages combined

  - `metadata.pagination.totalPageCount` (integer, required)
    Total number of pages available

  - `metadata.pagination.pageSize` (integer, required)
    Page size - number of items per result page configured by size query parameter or default page size

  - `metadata.pagination.currentPageSize` (integer, required)
    Number of items in current result page

  - `metadata.pagination.currentPageNumber` (integer, required)
    Current page number/ordinal

  - `dataSources` (array, required)

  - `dataSources.itemType` (string, required)
    Type of data source item.
    Enum: "audit", "web-journey"

  - `dataSources.itemId` (integer, required)

  - `dataSources.itemName` (string)

  - `dataSources.lastCompletedRun` (object)

  - `dataSources.lastCompletedRun.runId` (integer)
    Example: 33010

  - `dataSources.lastCompletedRun.completedAt` (string)

  - `dataSources.consentCategoryType` (string)
    Enum: "approved", "unapproved"

  - `dataSources.labels` (array, required)

  - `dataSources.labels.id` (integer, required)
    Label identifier
    Example: 223

  - `dataSources.labels.name` (string, required)

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 403 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)