Skip to main content
Menu

Get started

Getting started

From zero to your first response in five minutes.

1. Request a key

The API is available by application. Submit the access request form with your use case; approved partners receive a live key beginning ak_live_.

2. Make a request

Pass your key as a bearer token. The base URL is versioned:

bash
curl https://api.anglerpass.com/v1/guides?species=trout \
  -H "Authorization: Bearer ak_live_your_key"

No key? You can still call read endpoints anonymously at a lower rate limit — great for trying things out.

3. Read the envelope

Success and error responses share a predictable shape. Switch on success and, for errors, error.code — never the HTTP status or the human message.

node
const res = await fetch("https://api.anglerpass.com/v1/clubs?state=MT", {
  headers: { Authorization: `Bearer ${process.env.ANGLERPASS_API_KEY}` },
});
const body = await res.json();
if (!body.success) throw new Error(body.error.code);
console.log(body.data.clubs, body.meta.request_id);

Base URLs

Canonical: https://api.anglerpass.com/v1. During the subdomain rollout the same API is also reachable at https://anglerpass.com/api/v1. Both are stable.