Developer API

Build on Blueprint.

Integrate provider network data, adequacy scores, and pipeline status directly into your health plan's internal tools. RESTful API with webhooks, SDKs, and a sandbox environment.

Get API Key View Changelog

RESTful API

JSON over HTTPS with OAuth 2.0 bearer tokens. Rate-limited at 1,000 req/min on Pro and 10,000 req/min on Enterprise. Fully versioned endpoints, predictable pagination, and consistent error envelopes.

Webhooks

Real-time event delivery for provider stage changes, adequacy score updates, and campaign completions. Configurable retry logic with exponential back-off and signed payloads for verification.

Sandbox Environment

Full-featured test environment seeded with sample Arizona Medicare Advantage data. No production data touched. Sandbox API keys are separate and clearly labeled in every response header.

Interactive Preview

Explore the API response shapes.

GET /providers

// Response
{
  "data": [
    {
      "id": "prv_01HXYZ9KDRA",
      "name": "Dr. Maria Santos, MD",
      "specialty": "Internal Medicine",
      "county": "Maricopa",
      "stage": "LOI Sent",
      "adequacy_status": "compliant"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "per_page": 25
  }
}

Endpoint Reference

All endpoints require a valid bearer token unless noted otherwise.

Method	Endpoint	Description	Auth Required
GET	/v1/providers	List all providers in a build	Yes
POST	/v1/providers	Add a new provider	Yes
PATCH	/v1/providers/{id}	Update provider stage or status	Yes
GET	/v1/builds	List all network builds	Yes
GET	/v1/builds/{id}/adequacy	Get adequacy score for a build	Yes
GET	/v1/counties	List counties in a service area	Yes
POST	/v1/webhooks	Register a webhook endpoint	Yes
GET	/v1/events	List recent pipeline events	Yes

Official SDKs

Drop-in clients for the most common runtimes. Each SDK handles auth, retries, and pagination automatically.

JavaScript / TypeScript

npm install @blueprint-network/sdk

import Blueprint from
  '@blueprint-network/sdk'

const client = new Blueprint({
  apiKey: process.env.BLUEPRINT_KEY,
  sandbox: true
})

Python

pip install blueprint-network

from blueprint_network import Client

client = Client(
  api_key=os.environ["BLUEPRINT_KEY"],
  sandbox=True
)

REST / curl

No library required

curl -G \
  https://api.blueprintnetworkhub.com \
  /v1/providers \
  -H "Authorization: Bearer $KEY"

Rate Limits & Plans

Limits apply per API key. Burst headroom is 2x the per-minute limit for up to 10 seconds.

Plan	Requests / min	Webhooks	Sandbox
Starter	100	—	Yes
Professional	1,000	10 endpoints	Yes
Enterprise	10,000	Unlimited	Yes

Need higher limits? Talk to us.

Ready to integrate?

Grab an API key from your onboarding dashboard, point at the sandbox, and make your first call in minutes.

Get API Key View Changelog