> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.tradespace.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.tradespace.io/_mcp/server.

# departments

GraphQL QUERY

Returns a paginated collection of departments.

Reference: https://developer.tradespace.io/api-reference/queries/departments

## GraphQL Schema

```graphql
query ExampleQuery($ancestorIds: [String!], $contactIds: [String!], $createdByUserIds: [String!], $createdOnMax: ISO8601Date, $createdOnMin: ISO8601Date, $levels: [Int!], $limit: Int, $page: Int, $parentIds: [String!], $q: String, $sortDirection: SortDirectionEnum, $sortField: String, $sourceEnums: [DepartmentSourceEnum!], $updatedByUserIds: [String!], $updatedOnMax: ISO8601Date, $updatedOnMin: ISO8601Date) {
  departments(ancestorIds: $ancestorIds, contactIds: $contactIds, createdByUserIds: $createdByUserIds, createdOnMax: $createdOnMax, createdOnMin: $createdOnMin, levels: $levels, limit: $limit, page: $page, parentIds: $parentIds, q: $q, sortDirection: $sortDirection, sortField: $sortField, sourceEnums: $sourceEnums, updatedByUserIds: $updatedByUserIds, updatedOnMax: $updatedOnMax, updatedOnMin: $updatedOnMin) {
    collection {
      ancestors
      children
      contactsCount
      createdAt
      createdByUser
      createdByUserId
      disclosuresCount
      externalId
      filingsCount
      id
    }
    metadata {
      count
      currentPage
      extra
      hasNextPage
      hasPreviousPage
      limitValue
      nextPage
      previousPage
      totalCount
      totalPages
    }
  }
}
```

## Variables

```json
{
  "ancestorIds": [
    "example"
  ],
  "contactIds": [
    "example"
  ],
  "createdByUserIds": [
    "example"
  ],
  "createdOnMax": "example",
  "createdOnMin": "example",
  "levels": [
    0
  ],
  "limit": 0,
  "page": 0,
  "parentIds": [
    "example"
  ],
  "q": "example",
  "sortDirection": "ASC",
  "sortField": "example",
  "sourceEnums": [
    "admin"
  ],
  "updatedByUserIds": [
    "example"
  ],
  "updatedOnMax": "example",
  "updatedOnMin": "example"
}
```