Screens a household for a likely coverage pathway from state, household size and
Screens a household for a likely coverage pathway from state, household size and yearly income: Medicaid may qualify, Marketplace subsidy may qualify, coverage gap, or above the subsidy range. Uses 2026 federal poverty guidelines and KFF-reported state Medicaid limits, reports income as a percent of the poverty line and links the state Medicaid office. Screening estimate only; the state decides. Income is not stored or logged.
Answeringour last check, 2026-10-31
2 of 2checks answered this week
35 msmedian answer time
$0.01listed price per call
$0.01price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://api.findmydirectdoctor.com/v1/coverage/medicaid-check
| Category | Everything else |
|---|---|
| Provider host | api.findmydirectdoctor.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-31 | valid payment request | 402 | $0.01 | 36 ms |
| 2026-10-29 | valid payment request | 402 | $0.01 | 35 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"annual_income": 20000,
"household_size": 3,
"state": "KS"
},
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"age": {
"description": "Optional age of the applicant. At 65 or older the response adds a note that Medicare usually applies and is not modeled.",
"maximum": 120,
"minimum": 0,
"type": "integer"
},
"annual_income": {
"description": "Yearly household income in US dollars before taxes. It is not stored or logged by the application.",
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
"coverage_year": {
"default": 2027,
"description": "Coverage year for the Marketplace calculation.",
"enum": [
2026,
2027
],
"type": "integer"
},
"group": {
"default": "adult",
"description": "Which Medicaid group to screen: adult, parent, pregnant or child.",
"enum": [
"adult",
"parent",
"pregnant",
"child"
],
"type": "string"
},
"household_size": {
"description": "Number of people in the household, counting the applicant.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"state": {
"description": "2-letter US state code (or DC).",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
}
},
"required": [
"state",
"household_size",
"annual_income"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"annual_income_usd": {
"type": "number"
},
"apply_url": {
"type": [
"string",
"null"
]
},
"caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"conditions": {
"items": {
"type": "string"
},
"type": "array"
},
"data_as_of": {
"type": "string"
},
"details": {
"description": "Limits and guideline amounts used.",
"type": "object"
},
"disclaimer": {
"type": "string"
},
"facts_verified_on": {
"type": "string"
},
"fpl_percent": {
"description": "Income as a percent of the federal poverty guideline.",
"type": [
"number",
"null"
]
},
"headline": {
"type": "string"
},
"marketplace_fpl_percent": {
"type": [
"number",
"null"
]
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"pathway": {
"enum": [
"medicaid_may_qualify",
"marketplace_subsidy_may_qualify",
"coverage_gap",
"above_subsidy_range"
],
"type": "string"
},
"query": {
"description": "The request as understood. Income is not echoed in any log.",
"type": "object"
},
"source": {
"type": "string"
},
"state_medicaid_office_url": {
"type": [
"string",
"null"
]
},
"state_name": {
"type": "string"
}
},
"required": [
"pathway",
"headline",
"fpl_percent",
"state_medicaid_office_url",
"caveats",
"disclaimer"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}