|
| 1 | +# Safety Net OpenAPI Toolkit |
| 2 | +## Executive Summary |
| 3 | + |
| 4 | +### The Problem |
| 5 | + |
| 6 | +Building technology for safety net programs is challenging. Each state has different terminology, program names, and requirements. Development teams waste time reinventing solutions, integration between systems is slow and error-prone, and organizations often become locked into specific vendors' proprietary systems. |
| 7 | + |
| 8 | +### The Solution |
| 9 | + |
| 10 | +The Safety Net OpenAPI Toolkit provides **pre-built, shared API definitions for benefits eligibility programs**. Instead of starting from scratch, teams build on a common foundation that captures core concepts—applications, households, income, eligibility—while allowing for state-specific customization. |
| 11 | + |
| 12 | +### Key Capabilities |
| 13 | + |
| 14 | +- **Shared API Definitions** — Ready-to-use specifications for common benefits data, built on industry standards that any vendor can implement |
| 15 | +- **Simulated APIs** — Fully functional test environments generated automatically, enabling frontend development without waiting for backend systems |
| 16 | +- **Ready-to-Use Code Libraries** — Pre-built integration code that catches errors early and speeds up development |
| 17 | +- **State Customizations** — Adapt the shared definitions for each state's terminology and requirements without duplicating work |
| 18 | +- **One-Command API Creation** — Define a new data type once, and automatically get a complete API with documentation, test environment, and code libraries |
| 19 | + |
| 20 | +### Benefits |
| 21 | + |
| 22 | +| For | Value | |
| 23 | +|-----|-------| |
| 24 | +| **Development Teams** | Start building immediately; consistent patterns reduce bugs and ramp-up time | |
| 25 | +| **Program Managers** | Faster delivery; reduced coordination overhead between teams | |
| 26 | +| **States & Agencies** | Customizable for local requirements; no vendor lock-in since any provider can implement the shared definitions | |
| 27 | + |
| 28 | +### How It Works |
| 29 | + |
| 30 | +1. Teams start with pre-built API definitions for common benefits data |
| 31 | +2. State-specific customizations adapt terminology and requirements |
| 32 | +3. Documentation, test environments, and code libraries are generated automatically |
| 33 | +4. Backend teams implement against clear specifications with automated verification |
| 34 | +5. Improvements to the shared foundation benefit all participating states |
| 35 | + |
| 36 | +### Get Started |
| 37 | + |
| 38 | +Visit the [Toolkit Overview presentation](https://codeforamerica.github.io/safety-net-openapi/presentation/safety-net-openapi-overview.html) for a detailed walkthrough, or explore the [repository on GitHub](https://github.com/codeforamerica/safety-net-openapi). |
| 39 | + |
| 40 | +--- |
| 41 | + |
| 42 | +*Code for America — Enabling faster, more consistent API development for safety net programs.* |
0 commit comments