Organizations¶

Organizations are the unified Federal Hierarchy model exposed at /api/organizations/ (departments, agencies, offices, and other intermediate nodes).

If you’re looking for field definitions, see the Organizations Data Dictionary.

Endpoints¶

• GET /api/organizations/ (list + filtering + search)
• GET /api/organizations/{identifier}/ (detail — accepts either an integer Federal Hierarchy key or a UUID primary key)

Filtering¶

Response shaping¶

Organizations support shape=... (see Response Shaping).

Default shape (no ?shape= param):

key, fh_key, name, short_name, type, level, is_active, code, fpds_code, cgac, canonical_code, parent_fh_key, full_parent_path_name

All responses go through the shaping pipeline, even without a ?shape= parameter.

Root fields available via shaping:

Expansions:

# Default response (no shape param)
/api/organizations/

# Select specific fields
/api/organizations/?shape=fh_key,name,type,level

# Include department and agency expands
/api/organizations/?shape=fh_key,name,department(code,name),agency(code,name,abbreviation)

# Include enriched ancestors
/api/organizations/?shape=fh_key,name,ancestors(fh_key,name,short_name,level)

Ordering¶

/api/organizations/ does not support ordering=....

(Results are returned in a stable way; searches preserve their own relevance ordering, and non-search lists are returned in a consistent key order.)

Pagination¶

Organizations use standard page-number pagination:

• page (default 1)
• limit (max 100)

SDK examples¶

The SDKs don’t yet expose a first-class list_organizations() / listOrganizations() method. You can still call the endpoint via the SDK’s internal HTTP helper.

import os

from tango import TangoClient

client = TangoClient(api_key=os.environ["TANGO_API_KEY"])
data = client._get(
    "/api/organizations/",
    params={
        "search": "Treasury",
        "type": "DEPARTMENT|AGENCY",
        "include_inactive": "false",
        "limit": 25,
    },
)
print("count:", data.get("count"))

import { TangoClient } from "@makegov/tango-node";

const client = new TangoClient({ apiKey: process.env.TANGO_API_KEY });
const http = (client as any).http;

const data = await http.get("/api/organizations/", {
  search: "Treasury",
  type: "DEPARTMENT|AGENCY",
  include_inactive: "false",
  limit: 25,
});

console.log("count:", data.count);