API Documentation

Free public REST API for US federal government organizational data. All endpoints return JSON. No authentication required.

Rate limits: 100 requests per minute per IP. Data sourced from USAspending.gov, Federal Register, and official agency records.

GET/api/v1/agencies

List all agencies with optional filters

Name	Type	Description
branch	string	Filter by branch: executive, legislative, judicial
tag	string	Filter by category tag: defense, healthcare, finance, etc.
q	string	Search by name or leader
limit	number	Max results (default 100, max 500)
offset	number	Pagination offset (default 0)

/api/v1/agencies?branch=executive&limit=5

GET/api/v1/agencies/:id

Get a single agency by ID

Name	Type	Description
id	string	Agency ID (e.g., 'defense', 'nasa', 'fbi')

/api/v1/agencies/defense

GET/api/v1/agencies/:id/tree

Get an agency and all its sub-organizations as a tree

Name	Type	Description
id	string	Agency ID

/api/v1/agencies/defense/tree

GET/api/v1/leadership

List current federal officials with appointment details

Name	Type	Description
branch	string	Filter by branch
status	string	Filter by status: confirmed, acting, pending
q	string	Search by person name or agency
limit	number	Max results (default 100, max 500)
offset	number	Pagination offset (default 0)

/api/v1/leadership?status=acting&branch=executive

GET/api/health

Health check endpoint

/api/health

GovChart API is free and open. Data updates weekly from official government sources.

Questions? Contact us