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/.

Base URL: https://www.ruralcarejourney.com— rhtp.amemobile.net also works and remains supported for existing integrations.

View plan limits

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.

Program category taxonomy

programCategory is the canonical, sitewide way to filter by program subject matter — separate from opportunityType (the procurement/funding vehicle, e.g. RFP) and documentCategory (the file artifact, e.g. APPLICATION). It's supported as a query parameter on /api/v1/opportunities, /api/v1/awards, /api/v1/activities, and /api/v1/documents, and as a body field on /api/v1/search.

Current taxonomy version: 1.0. A request may use either a canonical ID below or one of the older legacy IDs (e.g. EMS_DEVELOPMENT) — legacy IDs are aliased automatically to their canonical equivalent and remain supported indefinitely during the compatibility period; an unrecognized value returns HTTP 400 with the supported list.

Canonical ID	Label	Legacy alias
`CARE_ACCESS_COORDINATION`	Care Access & Coordination	— (new in v1.0)
`EMS_MOBILE_INTEGRATED_HEALTH`	EMS & Mobile Integrated Health	`EMS_DEVELOPMENT`
`BEHAVIORAL_HEALTH`	Behavioral Health	— (new in v1.0)
`MATERNAL_CHILD_FAMILY_HEALTH`	Maternal, Child & Family Health	— (new in v1.0)
`CHRONIC_DISEASE_PREVENTION`	Chronic Disease & Prevention	— (new in v1.0)
`COMMUNITY_POPULATION_HEALTH`	Community & Population Health	`POPULATION_HEALTH`
`WORKFORCE_DEVELOPMENT`	Workforce Development	`WORKFORCE`
`HEALTH_IT_DATA_INTEROPERABILITY`	Health IT, Data & Interoperability

Every result also carries programCategoryEvidence — the source of each classification (ADMIN_CONFIRMED / EXTRACTED / INFERRED) and, for inferred matches, the specific matched terms. On /api/v1/opportunities, inferred categories are ranked (the record's own title/summary outweigh linked-document text) and capped at 3 — any additional genuine matches are still filterable but are reported separately in truncatedProgramCategories rather than dropped.

Endpoints

GET

/api/statsPublic

Public dashboard headline stats. No API key needed.

Request

curl https://www.ruralcarejourney.com/api/stats

Response

{
  "states": 50,
  "documents": 4980,
  "activities": 8986,
  "totalStateAward": 3586795659.8,
  "fundingCount": 673,
  "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

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	Per-minute or monthly allowance exceeded — check Retry-After and quota headers
500	Server error — contact support

API access and plan limits

PlanRateMonthlyAI answers

Pro60/min2,000250

Team120/min20,0001,000

Featured Vendor300/min20,0001,000

Monthly allowances reset at 00:00 UTC on the first day of each month. Responses include X-RateLimit-Monthly-Remaining and X-AI-Search-Monthly-Remaining. Account owners and administrators receive warnings at 80% and 100% usage.

Dedicated API plan

Build with Rural Care Journey for $99/month

Get a managed API key for opportunities, documents, events, awards, activity, state data, and optional AI-assisted search. Monthly usage resets at 00:00 UTC.

View API plan Manage API keys

10,000

requests / month

500

AI answers / month

120

requests / minute

managed API key

Includes quota response headers and account-owner/admin warnings at 80% and 100% usage.

GET

/api/v1/awardsAPI key required

Paginated list of state-level RHTP grant recipients across all 50 states. Returns individual award rows (awardee, amount, fiscal year) sourced from official state program documents. Only verified, non-duplicate records are returned.

Parameters

statequeryFilter by 2-letter state code, e.g. TX

fiscalYearqueryFilter by fiscal year, e.g. 2024 or FY2024 (partial match)

awardeequeryPartial name search, e.g. "rural health" (case-insensitive)

categoryqueryLegacy program category, e.g. EMS_DEVELOPMENT (kept for compatibility)

programCategoryqueryCanonical sitewide taxonomy category — accepts either a new ID (e.g. EMS_MOBILE_INTEGRATED_HEALTH) or a legacy one (aliased automatically)

pagequeryPage number (default 1)

limitqueryResults per page (default 100, max 500)

Request

# All grant recipients nationwide
curl "https://www.ruralcarejourney.com/api/v1/awards" \
  -H "Authorization: Bearer rhtp_..."

# Filter by state + fiscal year
curl "https://www.ruralcarejourney.com/api/v1/awards?state=TX&fiscalYear=2024" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "abc123...",
      "state": "TX",
      "stateName": "Texas",
      "fiscalYear": "FY2024",
      "awardeeName": "Texas Rural Health Network",
      "federalAmount": 1250000,
      "matchAmount": 250000,
      "activityType": "NETWORK_DEVELOPMENT",
      "programCategories": ["NETWORK_REGIONAL_COLLABORATION"],
      "programCategoryEvidence": [
        { "category": "NETWORK_REGIONAL_COLLABORATION", "source": "EXTRACTED", "taxonomyVersion": "1.0" }
      ],
      "programDescription": "Expand rural care coordination...",
      "sourceDocument": {
        "id": "doc123...",
        "title": "Texas RHTP Award Announcement FY2024",
        "fileType": "PDF",
        "url": "https://..."
      }
    }
  ],
  "pagination": { "page": 1, "limit": 100, "total": 842, "pages": 9 }
}

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

activityTypequeryLegacy program activity category, e.g. EMS_DEVELOPMENT (separate from document category; kept for compatibility)

programCategoryqueryCanonical sitewide taxonomy category — accepts either a new ID (e.g. EMS_MOBILE_INTEGRATED_HEALTH) or a legacy one (aliased automatically)

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://www.ruralcarejourney.com/api/v1/documents?upcoming=true&state=IA" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "abc123...",
      "title": "Iowa RHTP RFP — Care Coordination",
      "fileType": "PDF",
      "category": "APPLICATION",
      "documentCategory": "APPLICATION",
      "activityTypes": ["NETWORK_DEVELOPMENT"],
      "programCategories": ["NETWORK_REGIONAL_COLLABORATION"],
      "programCategoryEvidence": [
        { "category": "NETWORK_REGIONAL_COLLABORATION", "source": "EXTRACTED", "taxonomyVersion": "1.0" }
      ],
      "state": "IA",
      "fiscalYear": "FY2025",
      "award": null,
      "highlights": "Iowa expanded...",
      "url": "https://...",
      "applicationUrl": "https://grants.iowa.gov/apply/rhtp25",
      "nextDeadline": "2026-07-01T00:00:00.000Z",
      "keyDates": [
        { "label": "LOI due", "date": "2026-06-15" },
        { "label": "Applications due", "date": "2026-07-01" }
      ],
      "discovered": "2026-04-10T..."
    }
  ],
  "pagination": {
    "page": 1, "limit": 25,
    "total": 4, "pages": 1
  }
}

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)

categoryqueryLegacy program category, e.g. EMS_DEVELOPMENT (kept for compatibility; deterministic title/summary classifier)

programCategoryqueryCanonical sitewide taxonomy category — accepts either a new ID (e.g. EMS_MOBILE_INTEGRATED_HEALTH) or a legacy one (aliased automatically)

pagequeryPage number (default 1)

limitqueryMax results (default 25, max 100)

Request

curl "https://www.ruralcarejourney.com/api/v1/opportunities?state=IA&status=OPEN" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "abc123...",
      "slug": "ia-rhtp-care-coordination-rfp",
      "title": "Iowa RHTP Care Coordination RFP",
      "type": "RFP",
      "opportunityType": "RFP",
      "programCategories": ["CARE_ACCESS_COORDINATION"],
      "programCategoryEvidence": [
        {
          "category": "CARE_ACCESS_COORDINATION",
          "source": "INFERRED",
          "matchedTerms": ["care coordination"],
          "taxonomyVersion": "1.0"
        }
      ],
      "truncatedProgramCategories": [],
      "scope": "STATE",
      "state": "IA",
      "status": "OPEN",
      "issuingAgency": "Iowa HHS",
      "summary": "Request for proposals for care coordination...",
      "budgetMin": null,
      "budgetMax": 2500000,
      "applicantTypes": ["Non-profit", "Health system"],
      "postedDate": "2026-05-15T...",
      "dueDate": "2026-07-01T...",
      "loiDate": null,
      "questionDeadline": "2026-06-15T...",
      "sourceUrl": "https://hhs.iowa.gov/rfp/rhtp25",
      "documentCount": 3,
      "createdAt": "2026-05-15T...",
      "updatedAt": "2026-05-20T..."
    }
  ],
  "pagination": { "page": 1, "limit": 25, "total": 42, "pages": 2 }
}

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)

pagequeryPage number (default 1)

limitqueryMax results (default 25, max 100)

Request

curl "https://www.ruralcarejourney.com/api/v1/events?state=IN&status=UPCOMING&type=WEBINAR,TRAINING&limit=20" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "evt_abc123...",
      "title": "Indiana RHTP Budget Office Hours",
      "state": "IN",
      "stateName": "Indiana",
      "eventType": "OFFICE_HOURS",
      "status": "UPCOMING",
      "startAt": "2026-07-10T18:00:00.000Z",
      "endAt": "2026-07-10T19:00:00.000Z",
      "timezone": "ET",
      "hostAgency": "Indiana FSSA",
      "description": "Open Q&A for prospective applicants.",
      "registrationUrl": "https://example.gov/register",
      "recordingUrl": null,
      "slidesUrl": null,
      "sourceUrl": "https://example.gov/events/rhtp-office-hours",
      "topics": ["budget", "eligibility"],
      "audience": ["providers", "community organizations"],
      "confidence": "OFFICIAL",
      "isActive": true,
      "createdAt": "2026-06-01T12:00:00.000Z",
      "updatedAt": "2026-06-08T09:15:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 8, "pages": 1 }
}

GET

/api/v1/activitiesAPI key required

Structured RHTP program activities extracted from state documents. Supports category filtering such as EMS_DEVELOPMENT.

Parameters

statequeryFilter by state code

programCategoryqueryCanonical sitewide taxonomy category (or a legacy ID, aliased automatically). Activity.category is a fixed set with no room yet for the 7 categories new in taxonomy v1.0 — querying one of those returns an empty result, not an error.

statusqueryACTIVE | COMPLETED | PLANNED | CANCELLED

fiscalYearqueryFiscal year label

pagequeryPage number (default 1)

limitqueryMax results (default 100, max 500)

Request

curl "https://www.ruralcarejourney.com/api/v1/activities?state=IA&category=EMS_DEVELOPMENT" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [{
    "id": "activity123...",
    "state": "IA",
    "stateName": "Iowa",
    "fiscalYear": "FY2025",
    "category": "EMS_DEVELOPMENT",
    "programCategory": "EMS_MOBILE_INTEGRATED_HEALTH",
    "programCategoryEvidence": [
      { "category": "EMS_MOBILE_INTEGRATED_HEALTH", "source": "EXTRACTED", "taxonomyVersion": "1.0" }
    ],
    "title": "Community paramedicine expansion",
    "status": "ACTIVE"
  }],
  "pagination": { "page": 1, "limit": 100, "total": 12, "pages": 1 }
}

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://www.ruralcarejourney.com/api/v1/activity?type=NEW_OPPORTUNITY&since=2026-06-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer rhtp_..."

Response

Sample

{
  "data": [
    {
      "id": "...",
      "state": "IA",
      "type": "NEW_OPPORTUNITY",
      "summary": "New solicitation: Iowa RHTP Care Coordination RFP",
      "siteUrl": "https://hhs.iowa.gov/rfp/rhtp25",
      "documentId": "abc123...",
      "detail": {
        "opportunityId": "opp_xyz...",
        "opportunityType": "RFP",
        "category": "APPLICATION",
        "deadline": "2026-07-01",
        "applicationUrl": "https://grants.iowa.gov/apply/rhtp25",
        "budgetMin": null,
        "budgetMax": 2500000
      },
      "occurredAt": "2026-06-05T..."
    }
  ],
  "count": 1,
  "page": 1,
  "hasMore": false
}

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

programCategorybodyOptional canonical sitewide taxonomy category (or a legacy ID, aliased automatically)

limitbodyMax documents returned (default 10, max 50)

aiAnswerbodyInclude metered AI synthesis (default false)

Request

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

Response

Sample

{
  "documents": [
    {
      "id": "abc123...",
      "title": "Iowa EMS Strategic Plan",
      "fileType": "PDF",
      "category": "STRATEGY",
      "documentCategory": "STRATEGY",
      "programCategories": ["EMS_MOBILE_INTEGRATED_HEALTH"],
      "programCategoryEvidence": [
        { "category": "EMS_MOBILE_INTEGRATED_HEALTH", "source": "EXTRACTED", "taxonomyVersion": "1.0" }
      ],
      "state": "IA",
      "stateName": "Iowa",
      "fiscalYear": "FY2025",
      "highlights": "Iowa is expanding EMS coverage...",
      "url": "https://...",
      "discovered": "2026-04-10T..."
    }
  ],
  "count": 3,
  "hasMore": false,
  "aiAnswer": "Iowa and Nevada are both investing in EMS..."
}