---
title: "List Federal Organizations"
method: GET
path: "/api/v1/federal-hierarchy/"
tags: ["Federal Hierarchy"]
---

# List Federal Organizations

`GET /api/v1/federal-hierarchy/`

## Request

- Base URL: `https://govconapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://govconapi.com/api/v1/federal-hierarchy/`
- Auth: HTTP bearer

Search and filter the SAM Federal Hierarchy (~907 federal departments, agencies, and offices). All filters are optional. Free tier — available to any authenticated API key.

## Query parameters

- `type` string, nullable: Filter by type: DEPARTMENT or AGENCY (case-insensitive)
- `cgac` string, nullable: Filter by Treasury account code (e.g. 097 for DoD)
- `parent_id` integer, nullable: Filter by parent organization_id
- `hierarchy_level` integer, nullable: Filter by depth (1 = root department)
- `is_active` boolean, nullable: Filter by active status (default: true)
- `search` string, nullable: Match on canonical_name, short_name, or alternative_names (case-insensitive)
- `limit` integer: Results per page. Default 100; maximum 100 on the free trial and 1,000 on paid plans.
- `offset` integer: Pagination offset

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/govconapi/apis/govcon-api.md) · [All operations](https://skmtc.dev/govconapi/apis/govcon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govconapi/apis/govcon-api/revisions/32e498016218?raw)