Rural Care Journey API

REST API providing access to rural care journey state data, public documents, 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 by platform administrators. The GET /api/stats endpoint is public and requires no key.

Endpoints

GET

/api/statsPublic

Public dashboard headline stats. No API key needed.

Request

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

Response

{
  "states": 50,
  "documents": 1564,
  "activities": 3844,
  "totalStateAward": 12068734612.28,
  "fundingCount": 240,
  "federalTracked": true
}

GET

/api/v1/statesAPI key required

All 50 states with document counts, award totals, and summaries.

Request

curl https://rhtp.amemobile.net/api/v1/states \
  -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": 50
}

GET

/api/v1/states/:codeAPI key required

Full detail for one state including 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",
  "awardTotal": 5600000,
  "totalAwardByState": 5600000,
  "awardeeCount": 8,
  "activities": 45,
  "awardYears": [
    {
      "fiscalYear": "FY2025",
      "total": 2100000,
      "awardees": [
        {
          "name": "Iowa Rural Network",
          "total": 1250000
        }
      ]
    }
  ],
  "recentDocuments": [
    {
      "title": "Healthy Hometowns Proposal",
      "fileType": "PDF",
      "category": "STRATEGY",
      "award": 209000000,
      "url": "https://..."
    }
  ]
}

GET

/api/v1/documentsAPI key required

Paginated list of RHTP-relevant documents.

Parameters

statequeryFilter by state code, e.g. IA

yearqueryFiscal year, e.g. FY2025

pagequeryPage number (default 1)

limitqueryResults per page (default 25, max 100)

Request

curl "https://rhtp.amemobile.net/api/v1/documents?state=IA&limit=5" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "abc123...",
      "title": "Iowa RHTP Annual Report",
      "fileType": "PDF",
      "category": "REPORT",
      "state": "IA",
      "fiscalYear": "FY2025",
      "award": null,
      "highlights": "Iowa expanded...",
      "url": "https://...",
      "discovered": "2026-04-10T..."
    }
  ],
  "pagination": {
    "page": 1, "limit": 5,
    "total": 12, "pages": 3
  }
}

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",
  "category": "STRATEGY",
  "state": "IA",
  "fiscalYear": "FY2025",
  "award": 209000000,
  "budget": { "total": 250000000, "federal": 209000000, "match": 41000000 },
  "strategicGoals": ["Expand CAH network", ...],
  "milestones": [{ "date": "2025-07", "label": "Phase 1 launch" }],
  "implementationPhase": "IMPLEMENTING",
  "completenessScore": 87,
  "url": "https://..."
}

GET

/api/v1/activityAPI key required

Recent change events — new documents, page updates, site status changes.

Parameters

statequeryFilter by state code

typequeryNEW_DOCUMENT | PAGE_UPDATED | SITE_DOWN | SITE_RESTORED

limitqueryMax results (default 50, max 200)

Request

curl "https://rhtp.amemobile.net/api/v1/activity?state=IA&limit=10" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "...",
      "state": "IA",
      "type": "NEW_DOCUMENT",
      "summary": "New strategy document: ...",
      "documentId": "abc123...",
      "occurredAt": "2026-04-15T..."
    }
  ],
  "count": 10
}

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

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

{
  "documents": [
    {
      "title": "Iowa EMS Strategic Plan",
      "state": "IA",
      "highlights": "Iowa is expanding...",
      "url": "https://..."
    }
  ],
  "count": 3,
  "aiAnswer": "Iowa and Nevada are both investing in EMS..."
}

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
500	Server error — contact support