# Get all consent categories in the account

GET /v3/consent-categories/library

Endpoint: GET /v3/consent-categories/library
Security: API_Key

## Query parameters:

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

  - `pageSize` (integer)

  - `name` (string)
    filter the consent categories by name

  - `labels` (array)
    filter the items by labels

  - `type` (string)
    filter the items by a given item type
    Enum: "approved", "unapproved"

  - `cmpVendor` (string)
    filter the items by a given CMP vendor
    Enum: "ONE_TRUST"

  - `sortBy` (string)
    Enum: "name", "type", "updated_at"

  - `sortDesc` (boolean)
    Controls sorting order

## Response 200 fields (application/json):

  - `metadata` (object)
    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

  - `consentCategories` (array)

  - `consentCategories.name` (string)

  - `consentCategories.notes` (string)

  - `consentCategories.type` (string)
    Enum: "approved", "unapproved"

  - `consentCategories.id` (integer)
    ID of consent category
    Example: 3301

  - `consentCategories.isDefaultCC` (boolean)
    If true, this is the default consent category

  - `consentCategories.cmpData` (object)

  - `consentCategories.cmpData.cmpVendor` (string, required)
    Enum: "ONE_TRUST"

  - `consentCategories.cmpData.oneTrustCookieGroupDescription` (string)
    The OneTrust provided description of the group

  - `consentCategories.cmpData.oneTrustCookieGroupDomain` (string, required)
    The domain reported by OneTrust for which the consent group applies
    Example: "observepoint.com"

  - `consentCategories.cmpData.oneTrustCookieGroupId` (string, required)
    The OneTrust ID for the group
    Example: "C001"

  - `consentCategories.cmpData.oneTrustCookieGroupGeo` (string, required)
    The geographic location for which the consent group applies
    Example: "us, ut"

  - `consentCategories.cmpData.sourceUrl` (string)
    The full URL of the page where the CMP import was run
    Example: "https://example.com"

  - `consentCategories.updatedType` (string)
    Enum: "ONETRUST_IMPORT", "FILE_IMPORT", "APP_CREATE"

  - `consentCategories.updatedAt` (string)
    The last time this consent category was updated in UTC timezone

  - `consentCategories.itemCounts` (object)

  - `consentCategories.itemCounts.tags` (integer)
    the number of tags in this consent category

  - `consentCategories.itemCounts.cookies` (integer)
    the number of cookies in this consent category

  - `consentCategories.itemCounts.requestDomainsAndGeos` (integer)
    the number of request domain/geo location pairs in this consent category

  - `consentCategories.auditCount` (integer)
    the number of audits this consent category is assigned to

  - `consentCategories.labelIds` (array)

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

## Response 404 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)