Hunter Education API & Embeds

Requirements API

The free /api/requirements endpoint returns hunter education requirements for every state as JSON — field day rules, minimum age, online-only eligibility, course cost range, and the certifying agency.

GET /api/requirements

List all states with a summary of their hunter education requirements. Example: curl https://www.onlinehuntereducation.com/api/requirements

GET /api/requirements/:slug

Detailed requirements for a single state. Use the state's URL slug, e.g. /api/requirements/texas or /api/requirements/new-york. Returns slug, name, abbreviation, requiresFieldDay, minimumAge, minimumAgeOnlineOnly, courseCostRange, agencyName, agencyUrl, course providers, and notes.

GET /oembed?url={url}

oEmbed rich preview for any page URL on the site (state pages, the quiz, and the compare page), conforming to the oEmbed specification.

Embeddable Widgets

Embed the "Do I need hunter education?" quiz: <iframe src="https://www.onlinehuntereducation.com/embed/quiz" width="100%" height="600"></iframe>

Embed a state requirement card: <iframe src="https://www.onlinehuntereducation.com/embed/state?slug=texas" width="400" height="320"></iframe>

All embeds are free and include a "Powered by OnlineHunterEducation.com" attribution link.

Who It's For

The API and embeds are built for hunting blogs, forum communities, app developers, state agencies, and outdoor retailers who want up-to-date hunter education requirements data on their own sites.