Rural Care Journey API

REST API providing access to rural care journey state data, public documents, opportunities, events, change activity, and AI-powered search. All endpoints return JSON. Versioned under /api/v1/.

Authentication

Most endpoints require an API key. Pass it in one of two ways:

Authorization: Bearer rhtp_your_key_here
# or
X-Api-Key: rhtp_your_key_here

API keys are issued from your account settings and are available on paid plans. The GET /api/stats endpoint is public and requires no key.

PlanRate limit

Pro60 req/min

Team120 req/min

Featured Vendor300 req/min

Endpoints

GET

/api/statsPublic

Public dashboard headline stats. No API key needed.

Request

curl https://rhtp.amemobile.net/api/stats

Response

{
  "states": 50,
  "documents": 2268,
  "activities": 5526,
  "totalStateAward": 1494540005.98,
  "fundingCount": 335,
  "federalTracked": true
}

GET

/api/v1/statesAPI key required

States with document counts, award totals, and summaries. Returns up to 50 states (the full set) by default.

Parameters

limitqueryMax results (default 50, max 50)

regionqueryHHS region number, e.g. 7

Request

curl "https://rhtp.amemobile.net/api/v1/states?region=7" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "code": "IA",
      "name": "Iowa",
      "region": "7",
      "cahCount": 82,
      "summary": "Iowa's Healthy Hometowns...",
      "siteUrl": "https://hhs.iowa.gov/...",
      "documents": 12,
      "awardTotal": 5600000,
      "awardeeCount": 8,
      "lastActivity": "2026-04-15T..."
    }
  ],
  "count": 6
}

GET

/api/v1/states/:codeAPI key required

Full detail for one state including award history and 10 most recent documents.

Parameters

codepathTwo-letter state code, e.g. IA

Request

curl https://rhtp.amemobile.net/api/v1/states/IA \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "code": "IA",
  "name": "Iowa",
  "region": "7",
  "cahCount": 82,
  "population": 3200000,
  "ruralPercent": 38,
  "summary": "Iowa's program focuses on...",
  "sites": [{ "url": "https://hhs.iowa.gov/...", "label": "IA RHTP Primary" }],
  "documents": 20,
  "awardTotal": 5600000,
  "totalAwardByState": 5600000,
  "awardeeCount": 8,
  "activities": 45,
  "awardYears": [
    {
      "fiscalYear": "FY2025",
      "total": 2100000,
      "awardees": [{ "name": "Iowa Rural Network", "total": 1250000 }]
    }
  ],
  "recentDocuments": [
    {
      "id": "abc123...",
      "title": "Iowa RHTP Annual Report",
      "fileType": "PDF",
      "category": "REPORT",
      "fiscalYear": "FY2025",
      "award": null,
      "highlights": "Iowa expanded CAH network...",
      "url": "https://...",
      "discovered": "2026-04-15T..."
    }
  ]
}

GET

/api/v1/documentsAPI key required

Paginated list of RHTP-relevant documents with AI-extracted fields. For active solicitations (RFPs/RFAs/NOFOs) with structured deadlines, prefer /api/v1/opportunities.

Parameters

statequeryFilter by state code, e.g. IA

yearqueryFiscal year, e.g. FY2025

upcomingquerytrue → only documents with a future deadline (nextDeadline > now), sorted by nextDeadline ascending

pagequeryPage number (default 1)

limitqueryResults per page (default 25, max 100)

Request

# All docs with a future deadline
curl "https://rhtp.amemobile.net/api/v1/documents?upcoming=true&state=IA" \
  -H "Authorization: Bearer rhtp_..."

GET

/api/v1/documents/:idAPI key required

Full document record with all AI-extracted structured fields.

Parameters

idpathDocument UUID

Request

curl https://rhtp.amemobile.net/api/v1/documents/abc123... \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "id": "abc123...",
  "title": "Iowa Transformation Plan",
  "fileType": "PDF",
  "category": "STRATEGY",
  "state": "IA",
  "stateName": "Iowa",
  "fiscalYear": "FY2025",
  "award": 209000000,
  "budget": { "total": 250000000, "federal": 209000000, "match": 41000000 },
  "programHighlights": "Iowa's plan expands CAH network...",
  "strategicGoals": ["Expand CAH network"],
  "milestones": [{ "date": "2025-07", "label": "Phase 1 launch" }],
  "transformationStrategy": {
    "keyInitiatives": ["Hub-and-spoke model"],
    "approachSummary": "..."
  },
  "implementationPhase": "IMPLEMENTING",
  "completenessScore": 87,
  "applicationUrl": "https://grants.iowa.gov/apply/rhtp25",
  "pages": 42,
  "url": "https://..."
}

GET

/api/v1/opportunitiesAPI key required

Paginated list of RHTP opportunities — RFPs, RFAs, NOFOs, grants, and award announcements. This is the primary feed for active solicitations: deadlines are normalized structured fields (dueDate, loiDate, questionDeadline), not prose. Consolidated (duplicate families merged) with effective status applied.

Parameters

statequeryFilter by 2-letter state code

statusqueryOPEN | CLOSING_SOON | UPCOMING | AMENDED | CLOSED (effective status, computed)

typequeryRFP | RFA | NOFO | GRANT | AWARD | IFB | …

scopequerySTATE | NATIONAL

qqueryKeyword search in title + summary (disables cache)

pagequeryPage number (default 1)

limitqueryMax results (default 25, max 100)

GET

/api/v1/eventsAPI key required

Paginated list of RHTP events across states (town halls, webinars, trainings, recordings, and announcements).

Parameters

statequery2-letter state code, or comma-separated list (e.g. IA or IA,NE)

statusqueryUPCOMING | TODAY | PAST | CANCELLED | RECORDING_AVAILABLE (single or comma-separated)

fromqueryISO date/time lower bound on startAt (inclusive)

toqueryISO date/time upper bound on startAt (inclusive)

qqueryKeyword search in title + hostAgency + description (disables cache)

includeInactivequerytrue to include inactive events (default false)

GET

/api/v1/activityAPI key required

Recent change events across all states. Use type=NEW_OPPORTUNITY to poll for new solicitations. Supports backfill via since+page.

Parameters

statequeryFilter by state code

typequeryPAGE_UPDATED (default) | NEW_OPPORTUNITY | NEW_DOCUMENT | SITE_DOWN | SITE_RESTORED

sincequeryISO 8601 timestamp — return events after this date (disables cache)

pagequeryPage number for backfill pagination (default 1)

limitqueryMax results (default 25, max 100)

Request

# Poll for new opportunities
curl "https://rhtp.amemobile.net/api/v1/activity?type=NEW_OPPORTUNITY&since=2026-06-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

POST

/api/v1/searchAPI key required

Full-text search over RHTP documents with optional AI answer synthesis.

Parameters

querybodySearch query (required, min 3 chars)

statesbodyOptional array of state codes to filter

yearbodyOptional fiscal year filter

limitbodyMax documents returned (default 10, max 50)

aiAnswerbodyInclude AI synthesis (default true)

Request

curl -X POST https://rhtp.amemobile.net/api/v1/search \
  -H "Authorization: Bearer rhtp_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "EMS workforce development",
    "states": ["IA", "NV"],
    "aiAnswer": true
  }'

Response

Sample

Error codes

Status	Meaning
200	Success
400	Bad request — missing or invalid parameter
401	No API key provided
403	Invalid or revoked API key
404	Resource not found
429	Rate limit exceeded — check Retry-After header
500	Server error — contact support