Reference

Example requests

Copy-paste starting points in curl, JavaScript, and Python.

Find trout properties in Colorado

bash

curl "https://api.anglerpass.com/v1/properties?state=CO&species=trout&limit=10" \
  -H "Authorization: Bearer $ANGLERPASS_API_KEY"

Search guides by technique

node

const url = new URL("https://api.anglerpass.com/v1/guides");
url.searchParams.set("techniques", "dry fly,nymphing");
url.searchParams.set("min_rating", "4.5");

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.ANGLERPASS_API_KEY}` },
});
const { success, data, error } = await res.json();
if (!success) throw new Error(error.code);
console.log(data.guides.map((g) => g.display_name));

Check a property's availability

python

import os, requests

r = requests.get(
    "https://api.anglerpass.com/v1/availability",
    params={"property_id": "e2b1c0d4-3a5f-4c6e-9b7a-1d2e3f4a5b6c"},
    headers={"Authorization": f"Bearer {os.environ['ANGLERPASS_API_KEY']}"},
)
body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])
for day in body["data"]["days"]:
    print(day["date"], day["status"])

Identify the calling key

bash

curl https://api.anglerpass.com/v1/me \
  -H "Authorization: Bearer $ANGLERPASS_API_KEY"