← Return to documentation

Tables & Example Queries

The API data includes four tables: gestational_limits, insurance_coverage, minors, and waiting_periods. The supported queries for each table are documented below.


API Structure

Each of our tables support only GET requests. All requests must include a header with the form:

{
    “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/ return policies for specific states (can also index by abbreviation)

/v1/table/zips/ 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 section.


Gestational Limits

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.


Query: /v1/gestational_limits/states/

Response: is a bit long to include here.

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"
    }
}

 

Insurance Coverage

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.


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
    }
}

 

Minors

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.


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
    }
}

 

Waiting Periods

This table covers abortion restrictions related to time periods that people must wait between receiving abortion counseling and getting abortion care. You can learn what exactly we mean by each of the fields returned on the Field References page.


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

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."
    }
}