List / search

Search and filter the SAM Federal Hierarchy: the canonical tree of federal departments, agencies, offices, bureaus, and commands (907 organizations as of 2026-07-10). Use it to resolve and normalize agency identity, walk the org tree, or join external datasets on Treasury cgac codes. Free with any key; this is reference data.

Parameters

type - Org type, uppercased: DEPARTMENT, AGENCY, OFFICE, BUREAU, MAJOR COMMAND, SUB COMMAND, DIVISION.
cgac - Treasury Common Government-wide Accounting Code, e.g. 097 (DoD), 017 (Navy). Many orgs share a department's cgac.
parent_id - Filter to immediate children of this organization_id.
hierarchy_level - Depth; 1 = root department.
is_active - Defaults to true. Pass is_active=false to include inactive orgs.
search - Case-insensitive match across canonical name, short name, and alternative names (≥ 2 chars).
limit - Results per page. Default 100; maximum 100 on the free trial and 1,000 on paid plans. Over the maximum returns 402.
offset - ≥ 0.

Response (list rows, 9 fields)

{
  "data": [
    {
      "organization_id": 300000188,
      "fh_key": "300000188",
      "cgac": "017",
      "canonical_name": "DEPT OF THE NAVY",
      "short_name": "USN",
      "type": "AGENCY",
      "hierarchy_level": 2,
      "parent_id": 100000000,
      "is_active": true
    }
  ],
  "pagination": { "limit": 50, "offset": 0, "total": 1, "has_next": false }
}

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/federal-hierarchy?search=navy&limit=10"

Note: Both /federal-hierarchy and /federal-hierarchy/ work; no redirect. total is exact. Results ordered by hierarchy_level then canonical_name. Reference data; expect rare changes. Key your joins on organization_id (stable integer).