Tables & Example Queries
Each of our tables support only GET requests. All requests must include a header with the following form:
API Structure
-
{
“token”: “YOUR_API_KEY”
}
Every table can be queried to provide information for every state, for a specific state, or for a specific zip code. The endpoints for these are:
/v1/table/states/ return policies for all states
/v1/table/states/<state_name data-preserve-html-node="true"> return policies for specific states (can also index by abbreviation)
/v1/table/zips/<zip_code data-preserve-html-node="true"> return policies for specific zip code
Examples of such routes for the tables are included below. For complete code examples, please see the Getting Started page in Documentation.
This table returns the restrictions on abortion access related to gestational limits, i.e. bans on abortion after a certain week in pregnancy. You can learn what exactly we mean by each of the fields returned on the Field References page.
Gestational limits
-
Query: /v1/gestational_limits/states/
Response: (this is a bit long to include here. it would return information for all states)
Query: /v1/gestational_limits/states/CA
Response:
{
"California": {
"banned_after_weeks_since_LMP": 99,
"exception_life": true,
"exception_health": "Any",
"Last Updated": "2018-05-31T11:51:00.000Z"
}
}
Query: /v1/gestational_limits/states/New%20York
Response:
{
"New York": {
"banned_after_weeks_since_LMP": 26,
"exception_life": true,
"Last Updated": "2018-05-31T11:45:00.000Z"
}
}
Query: /v1/gestational_limits/zips/71602
Response:
{
"Arkansas": {
"banned_after_weeks_since_LMP": 22,
"exception_life": true,
"exception_rape_or_incest": true,
"exception_health": "Physical"
}
}
This table covers abortion restrictions that specifically restrict what type of insurance coverage can be used to cover abortion (both Medicaid and private insurance). You can learn what exactly we mean by each of the fields returned on the Field References page.
Insurance coverage
-
Query: /v1/insurance_coverage/states/
Response: is a bit long to include here.
Query: /v1/insurance_coverage/states/FL
Response:
{
"Florida": {
"exchange_exception_life": true,
"exchange_exception_rape_or_incest": true,
"medicaid_exception_life": true,
"medicaid_exception_rape_or_incest": true,
"private_coverage_no_restrictions": true
}
}
Query: /v1/insurance_coverage/states/Texas
Response:
{
"Texas": {
"private_exception_life": true,
"private_exception_health": "Major Bodily Function",
"exchange_exception_life": true,
"exchange_exception_health": "Major Bodily Function",
"medicaid_exception_life": true,
"medicaid_exception_rape_or_incest": true,
"Last Updated": "2018-06-02T19:00:31.000Z"
}
}
Query: /v1/insurance_coverage/zips/99508
Response:
{
"Alaska": {
"private_coverage_no_restrictions": true,
"exchange_coverage_no_restrictions": true,
"medicaid_coverage_medically_necessary": true
}
}
This table covers abortion restrictions that specifically target minors. You can learn what exactly we mean by each of the fields returned on the Field References page.
Minors
-
Query: /v1/minors/states/
Response: is a bit long to include here.
Query: /v1/minors/states/CO
Response:
{
"Colorado": {
"parents_required": 1,
"below_age": 18,
"parental_notification_required": true,
"judicial_bypass_available": true
}
}
Query: /v1/minors/states/Rhode%20Island
Response:
{
"Rhode Island": {
"parents_required": 1,
"below_age": 18,
"parental_consent_required": true,
"judicial_bypass_available": true
}
}
Query: /v1/minors/zips/82002
Response:
{
"Wyoming": {
"parents_required": 1,
"below_age": 18,
"parental_consent_required": true,
"parental_notification_required": true,
"judicial_bypass_available": true
}
}
This table covers abortion restrictions around waiting periods and mandated counseling. You can learn what exactly we mean by each of the fields returned on the Field References page.
Waiting periods
-
Query: /v1/waiting_periods/states/
Response: is a bit long to include here.
Query: /v1/waiting_periods/states/UT
Response:
{
"Utah": {
"waiting_period_hours": 72,
"counseling_visits": 2,
"counseling_waived_condition": "If the pregnancy is the result of rape or incest or the patient is younger than 15."
}
}
Query: /v1/waiting_periods/states/Virginia
Response:
{
"Virginia": {
"waiting_period_hours": 24,
"counseling_visits": 2,
"counseling_waived_condition": "The ultrasound must take place at least 24 hours before the abortion unless the patient lives more than 100 miles from an abortion provider.",
"Last Updated": "2018-05-31T12:24:00.000Z"
}
}
Query: /v1/waiting_periods/zips/57105
Response:
{
"South Dakota": {
"waiting_period_hours": 72,
"counseling_visits": 2,
"waiting_period_notes": "Weekends and holidays do not count towards the 72-hour waiting period."
}
}