# simpler-grants-protocol | U.S. Department of Health & Human Services | Knowledge Base | Instagit

A common standard for sharing data in the grant ecosystem.

GitHub Stars: 21

Repository: https://github.com/hhs/simpler-grants-protocol

---

## Articles

### [Data Validation in the TypeScript SDK for CommonGrants: A Complete Guide](/hhs/simpler-grants-protocol/commongrants-ts-sdk-data-validation-zod)

Explore dual-layer data validation in the CommonGrants TypeScript SDK using Zod for runtime and compile-time safety. Ensure API requests and responses conform to the protocol.

- Tags: how-to-guide
- Published: 2026-03-03

### [Technologies Used in the Development of CommonGrants: A Deep Dive into the Simpler Grants Protocol Stack](/hhs/simpler-grants-protocol/commongrants-development-technologies)

Discover the technologies behind CommonGrants. Explore TypeSpec, TypeScript, Python SDKs, Astro, React, and GitHub Actions in this deep dive into the Simpler Grants Protocol stack.

- Tags: deep-dive
- Published: 2026-03-03

### [How CommonGrants Handles Pagination, Filtering, and Sorting: A Technical Guide](/hhs/simpler-grants-protocol/commongrants-pagination-filtering-sorting)

Learn how CommonGrants uses Zod schemas for type-safe pagination filtering and sorting. Discover HHS simpler grants protocol's automatic client-side SDK handling.

- Tags: technical-guide
- Published: 2026-03-03

### [CommonGrants Protocol Data Models: Zod Schemas for Grant Opportunities](/hhs/simpler-grants-protocol/commongrants-protocol-data-models)

Explore CommonGrants protocol data models using Zod schemas. Discover OpportunityBase, OppStatus, OppFunding, and OppTimeline definitions for grant opportunities. Learn more.

- Tags: api-reference
- Published: 2026-03-03

### [CommonGrants API Optional Endpoints: Extended Routes for Advanced Grant Management](/hhs/simpler-grants-protocol/commongrants-api-optional-endpoints)

Discover CommonGrants API optional endpoints for extended grant management features like direct applications and reusable forms. Enhance your implementation without breaking core compliance.

- Tags: api-reference
- Published: 2026-03-03

### [Core API Routes Defined in CommonGrants: A Complete TypeSpec Reference](/hhs/simpler-grants-protocol/commongrants-api-core-routes)

Explore the core API routes in CommonGrants, a TypeSpec reference detailing five HTTP endpoints for opportunity management with full CRUD operations and auto-generated SDK clients.

- Tags: api-reference
- Published: 2026-03-03

### [How CommonGrants Supports Custom Fields: Typed Schema Extensions for Grant Opportunities](/hhs/simpler-grants-protocol/commongrants-custom-fields-support)

Discover how CommonGrants supports custom fields using typed schema extensions. Enable strong typing and TypeScript autocomplete for your grant opportunities with the withCustomFields extension.

- Tags: how-to-guide
- Published: 2026-03-03

### [CommonGrants Versioning Strategy: TypeSpec-Driven Semantic Versioning Explained](/hhs/simpler-grants-protocol/commongrants-protocol-versioning-strategy)

Discover the CommonGrants versioning strategy. Learn how TypeSpec-driven semantic versioning and @Versioning decorators ensure clear API version provenance.

- Tags: architecture
- Published: 2026-03-03

### [Does CommonGrants Generate OpenAPI Specifications?](/hhs/simpler-grants-protocol/commongrants-openapi-generation)

Yes CommonGrants generates OpenAPI 3.0 specifications. Learn about its TypeSpec compilation pipeline and FastAPI helper script for automated spec generation.

- Tags: deep-dive
- Published: 2026-03-03

### [How the CommonGrants Specification Is Built: From YAML to TypeScript SDK](/hhs/simpler-grants-protocol/commongrants-specification-built-with-typespec)

Discover how the CommonGrants specification is built from YAML to a TypeScript SDK using a schema-first approach. Learn about the tools and processes involved.

- Tags: internals
- Published: 2026-03-03

### [CommonGrants Protocol Specification: Key Features and Implementation Guide](/hhs/simpler-grants-protocol/commongrants-protocol-key-features)

Explore the CommonGrants protocol specification a stable API contract for sharing grant data. Learn its key features and implementation guide for flexible compliance.

- Tags: how-to-guide
- Published: 2026-03-03

### [CommonGrants Protocol Example Implementations: A Complete Guide](/hhs/simpler-grants-protocol/commongrants-example-implementations-location)

Explore CommonGrants protocol example implementations in the hhs/simpler-grants-protocol repository. Learn with FastAPI and Python SDK for Pennsylvania and California APIs.

- Tags: how-to-guide
- Published: 2026-03-03

### [CommonGrants Python SDK: Complete Guide to Installation and Usage](/hhs/simpler-grants-protocol/commongrants-python-sdk-availability)

Install and use the CommonGrants Python SDK to interact with CommonGrants APIs. This guide covers installation, Pydantic models, data transformation, and HTTP client usage.

- Tags: getting-started
- Published: 2026-03-03

### [CommonGrants TypeScript SDK: Complete Guide to Installation and Usage](/hhs/simpler-grants-protocol/commongrants-typescript-sdk-availability)

Discover the CommonGrants TypeScript SDK for seamless integration. Learn installation and usage for fully typed, authentication-aware clients. Get started today.

- Tags: tutorial
- Published: 2026-03-03

### [CommonGrants CLI Commands: Complete Developer Workflow Guide](/hhs/simpler-grants-protocol/commongrants-cli-available-commands)

Explore CommonGrants CLI commands init compile preview check to scaffold projects compile TypeSpec to OpenAPI preview specs and validate implementations Unlock a streamlined developer workflow with cg

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Use the CommonGrants CLI Tool for Protocol Development](/hhs/simpler-grants-protocol/how-to-use-commongrants-cli-tool)

Learn to use the CommonGrants CLI tool for protocol development. Initialize projects, compile TypeSpec to OpenAPI, preview specs, and validate standards with `cg`.

- Tags: how-to-guide
- Published: 2026-03-03

### [What Is the Core Library in the CommonGrants Project?](/hhs/simpler-grants-protocol/commongrants-core-library-purpose)

Discover the CommonGrants core library at @common-grants/core. Learn about its foundational namespace, diagnostics, and utility functions powering the entire ecosystem.

- Tags: deep-dive
- Published: 2026-03-03

### [Where to Find CommonGrants Documentation and OpenAPI Specs](/hhs/simpler-grants-protocol/commongrants-documentation-openapi-specs-location)

Easily find CommonGrants documentation and OpenAPI specs in the hhs/simpler-grants-protocol repository or on commongrants.org. Get the information you need quickly.

- Tags: api-reference
- Published: 2026-03-03

### [CommonGrants Project Structure: A Complete Guide to the hhs/simpler-grants-protocol Architecture](/hhs/simpler-grants-protocol/commongrants-project-structure-components)

Explore the CommonGrants project structure in this guide to the hhs/simpler-grants-protocol architecture. Understand its eight interconnected components and specification-first design.

- Tags: architecture
- Published: 2026-03-03

### [Who Maintains the CommonGrants Protocol? HHS Stewardship and Governance Explained](/hhs/simpler-grants-protocol/who-maintains-commongrants-protocol)

Discover who maintains the CommonGrants protocol. Learn about HHS stewardship and the upcoming community governance for this grant management standard on the SimplerGrants initiative.

- Tags: how-to-guide
- Published: 2026-03-03

### [CommonGrants vs Simpler Grants Protocol: Understanding the Architecture](/hhs/simpler-grants-protocol/commongrants-vs-simpler-grants-protocol)

Compare CommonGrants an open API spec to Simpler Grants Protocol its full ecosystem of tools and governance. Understand their architectural differences.

- Tags: architecture
- Published: 2026-03-03

### [What Is the CommonGrants Protocol? A Complete Guide to the Open-Source Grant Data Standard](/hhs/simpler-grants-protocol/what-is-commongrants-protocol)

Discover the CommonGrants protocol, an open-source standard for seamless grant data exchange between funders, applicants, and platforms. Learn about its purpose with this complete guide.

- Tags: getting-started
- Published: 2026-03-03