Skip to content

Single organization

Look up one federal organization by integer ID, returning its full 17-field record plus its parent, immediate children, and full ancestor chain in a single call. Useful for rendering breadcrumbs, expanding tree nodes, or joining a downstream dataset against the org tree without extra round-trips.

Parameters

  • organization_id (path) - Integer org ID. Non-integer returns 422; unknown ID returns 404.

Response

{
  "data": {
    "organization_id": 300000188,
    "fh_key": "300000188",
    "cgac": "017",
    "canonical_name": "DEPT OF THE NAVY",
    "short_name": "USN",
    "alternative_names": ["USN", "..."],
    "type": "AGENCY",
    "description": "...",
    "is_active": true,
    "parent_id": 100000000,
    "hierarchy_level": 2,
    "hierarchy_path": [100000000, 300000188],
    "hierarchy_names": ["DEPT OF DEFENSE", "DEPT OF THE NAVY"],
    "source_modified_at": "...",
    "source_indexed_at": "...",
    "last_seen": "...",
    "source_version": "..."
  },
  "parent":    { /* 9-field list-shape row; null for root departments */ },
  "children":  [ { /* 9-field rows, immediate children, name-sorted */ } ],
  "ancestors": [ { /* 9-field rows, root department first */ } ]
}

Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://govconapi.com/api/v1/federal-hierarchy/300000188"

Errors: 401, 404 (unknown ID), 422 (non-integer path), 429.

Note: data is the full 17-field record; parent / children / ancestors are the 9-field list shape. hierarchy_path is the ordered list of ancestor IDs (root first), the same source used to build the inline ancestors array.

A REST API and MCP server for U.S. federal procurement data.

Get a free key, emailed instantly, or follow the quickstart.

Found something wrong, missing or confusing on this page?

Press Ctrl + Enter to send a note. Highlight text first and it travels with your note.