Rules API documentation

Verified nursing license renewal and CE rules for all 50 states plus DC, with per-record provenance. Base URL https://www.renewrn.net. Machine-readable spec: openapi.json.

Authentication

Most endpoints are open. The bulk download requires a free API key, emailed in seconds from the data page or via POST /api/v1/keys. Send it either way:

Authorization: Bearer rrn_YOUR_KEY
x-api-key: rrn_YOUR_KEY

Limits: 60/minute per IP on open endpoints, 60/minute per key on gated ones, 30/minute per IP on the MCP server. 429 responses are JSON with the limit stated.

The response envelope

Every JSON response wraps its payload with version, timestamps, and terms. latestVerificationis the newest last-verified date across all 51 jurisdictions, the honest "data as of" signal.

{
  "version": "v1",
  "generatedAt": "2026-06-10T18:00:00.000Z",
  "latestVerification": "2026-06-05",
  "license": "...",
  "attribution": "Data: RenewRN Rules (https://www.renewrn.net/data)",
  "disclaimer": "Informational only. Verify against the state board of nursing before acting. Not legal advice.",
  "docs": "https://www.renewrn.net/data",
  "data": ...
}

State records carry a meta block (board name, board URL, source URLs, lastVerified) and structured requirements with optionPathway and conditional flags. When optionPathway is true, CE is one of several competency options, not an unconditional mandate. Never present those hours as a fixed requirement.

Endpoints

GET/api/v1/statesAPI key required

All 51 jurisdictions (bulk download; free API key required)

Returns every jurisdiction's renewal rules in the standard envelope. Pass ?format=csv for a flat per-state table (scalar columns only; requirement-level detail is JSON-only). Requires a FREE API key (self-serve at POST /api/v1/keys); single-state lookups and the other endpoints need no key.

Parameter	In	Required	Notes
format	query	no	One of: csv

Responses: 200 · 400 · 401 · 429

curl -H "Authorization: Bearer rrn_YOUR_KEY" \
  https://www.renewrn.net/api/v1/states

# CSV
curl -H "Authorization: Bearer rrn_YOUR_KEY" \
  "https://www.renewrn.net/api/v1/states?format=csv" -o rules.csv

POST/api/v1/keys

Request a free API key (emailed)

Self-serve key issuance for the bulk endpoints. The key is emailed to verify the address; it is never returned in the response and only a hash is stored.

Responses: 200 · 400 · 429

curl -X POST https://www.renewrn.net/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com"}'

GET/api/v1/states/{code}

One jurisdiction

Parameter	In	Required	Notes
code	path	yes	Two-letter code (TX) or slug (texas).

Responses: 200 · 404 · 429

curl https://www.renewrn.net/api/v1/states/tx
curl https://www.renewrn.net/api/v1/states/texas

GET/api/v1/changes

Verified regulatory changes

Most recent first. ?since filters on loggedDate (when RenewRN verified and published the change, the 'what's new since I last polled' semantic); effectiveDate is also returned so consumers can re-filter.

Parameter	In	Required	Notes
state	query	no	string
since	query	no	YYYY-MM-DD

Responses: 200 · 400 · 429

curl "https://www.renewrn.net/api/v1/changes?state=TX&since=2026-01-01"

GET/api/v1/freshness

Dataset maintenance proof

Coverage totals from the data-integrity orchestrator and the last daily verification run.

Responses: 200 · 429

curl https://www.renewrn.net/api/v1/freshness

MCP server

Mount the ruleset as a tool in any MCP-capable agent (streamable HTTP, no key). Tools: get_state_requirements, list_states, get_recent_changes. Every payload embeds provenance, the disclaimer, and attribution.

{ "mcpServers": { "renewrn-rules": { "url": "https://www.renewrn.net/api/rules/mcp" } } }

claude mcp add --transport http renewrn-rules https://www.renewrn.net/api/rules/mcp

Terms and attribution

Free for evaluation and non-commercial use with attribution; commercial use requires an agreement. Full terms: data license. Informational only. Verify against the state board of nursing before acting. Not legal advice.