---
title: "Search for Departments"
method: POST
path: "/v1/departments/search"
tags: ["Departments"]
---

# Search for Departments

`POST /v1/departments/search`

## Request

- Base URL: `https://api.accredible.com`
- URL: `https://api.accredible.com/v1/departments/search`
- Auth: API key in header `Authorization`

You can search for departments by various search criteria.

Authorization depends on the type of API key you use:

| Account-wide key | Department-specific key |
| --- | --- |
| All Departments in the account | Its own Department only |

## Request body

- object
  - `meta_data` object
  - `page_size` number: The pagination response size, default of 50.
  - `page` number: The pagination page.

## Response `200`

OK

- object
  - `departments` object
    - `id` number
    - `name` string
    - `description` string
    - `url` string
    - `logo` string
    - `page_banner` string
    - `whitelabel_logo` string
    - `linkedin_company_id` string
    - `meta_data` object
      - `internal_id` string
      - `faculty` string
    - `generate_private_credential` boolean

## Changes

- **2025-07-08** `a93800de3a85`: 4 warning, 2 info
  - deleted the `query` request parameter `meta_data`
  - deleted the `query` request parameter `page`
  - deleted the `query` request parameter `page_size`
  - removed the request property `meta_data/faculty`
  - …2 more
- **2025-07-08** `98201e8dd1b4`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `ApiKeyAuth` was added to the API

[Operation history](https://skmtc.dev/accredible/apis/accredible-credential-api/changes/v1/departments/search/post.md)

---

[API](https://skmtc.dev/accredible/apis/accredible-credential-api.md) - [All operations](https://skmtc.dev/accredible/apis/accredible-credential-api/llms.txt) - [OpenAPI document](https://skmtc.dev/accredible/apis/accredible-credential-api/revisions/dfd510ea66d5?raw)