Reference

API reference

Every v1 endpoint. Base URL https://api.anglerpass.com/v1. All responses use the standard envelope.

get/health

Service health probe

Liveness check. Returns no PII or business data.

example response · GET /health

{
  "success": true,
  "data": {
    "status": "ok",
    "version": "2026-07-01"
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/properties

List published fishing properties

Public, discovery-safe properties. Coordinates are approximate (2 km jitter); exact locations, gate codes, access notes and financial terms are never returned.

Parameters

statequery
water_typequery
speciesquery
qquery
boundsquery
limitquery— Page size (1–100, default 25).
offsetquery— Rows to skip (default 0).

example response · GET /properties

{
  "success": true,
  "data": {
    "properties": [
      {
        "id": "e2b1c0d4-3a5f-4c6e-9b7a-1d2e3f4a5b6c",
        "name": "Upper Roaring Fork — Beat 3",
        "location_description": "Near Basalt, Colorado",
        "state": "CO",
        "water_type": "river",
        "species": [
          "Rainbow Trout",
          "Brown Trout"
        ],
        "regulations": "Catch and release, single barbless hook",
        "max_rods": 4,
        "rate_adult_full_day": 450,
        "latitude": 39.3689,
        "longitude": -107.0331,
        "coordinates_precision": "approximate"
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/properties/{id}

Retrieve a single published property

Parameters

idpathrequired— Property UUID.

example response · GET /properties/{id}

{
  "success": true,
  "data": {
    "property": {
      "id": "e2b1c0d4-3a5f-4c6e-9b7a-1d2e3f4a5b6c",
      "name": "Upper Roaring Fork — Beat 3",
      "water_type": "river",
      "coordinates_precision": "approximate"
    }
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/guides

List live, verified fishing guides

Public guide directory (background-checked, live guides only). Ranked Pro tier first, then rating. Credential documents and verification state are never returned.

Parameters

speciesquery
techniquesquery
locationquery
min_ratingquery
limitquery— Page size (1–100, default 25).
offsetquery— Rows to skip (default 0).

example response · GET /guides

{
  "success": true,
  "data": {
    "guides": [
      {
        "id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
        "display_name": "Casey Rivers",
        "base_location": "Bozeman, Montana",
        "species": [
          "Trout"
        ],
        "techniques": [
          "Dry fly",
          "Nymphing"
        ],
        "rate_full_day": 650,
        "rating_avg": 4.9,
        "rating_count": 42,
        "membership_tier": "pro"
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/clubs

List active fishing clubs

Parameters

qquery
statequery
limitquery— Page size (1–100, default 25).
offsetquery— Rows to skip (default 0).

example response · GET /clubs

{
  "success": true,
  "data": {
    "clubs": [
      {
        "id": "b2c3d4e5-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
        "name": "Headwaters Angling Club",
        "slug": "headwaters-angling-club",
        "state": "MT",
        "location": "Southwest Montana"
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/fly-shops

List live fly-shop partners

Parameters

statequery
limitquery— Page size (1–100, default 25).
offsetquery— Rows to skip (default 0).

example response · GET /fly-shops

{
  "success": true,
  "data": {
    "fly_shops": [
      {
        "id": "c3d4e5f6-7a8b-4c9d-0e1f-2a3b4c5d6e7f",
        "slug": "gallatin-river-outfitters",
        "shop_name": "Gallatin River Outfitters",
        "state": "MT",
        "is_pro": true
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/availability

Get a property's public availability calendar

Date + status only (available/blocked/booked/maintenance). Requires a published property_id.

Parameters

property_idqueryrequired
fromquery
toquery

example response · GET /availability

{
  "success": true,
  "data": {
    "property_id": "e2b1c0d4-3a5f-4c6e-9b7a-1d2e3f4a5b6c",
    "from": "2026-07-01",
    "to": "2026-09-29",
    "days": [
      {
        "date": "2026-07-04",
        "status": "booked"
      },
      {
        "date": "2026-07-05",
        "status": "available"
      }
    ]
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}

get/meKey required

Identify the calling API key

Returns the authenticated key's owner, scopes, and rate tier.

example response · GET /me

{
  "success": true,
  "data": {
    "key_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "scopes": [
      "properties:read",
      "guides:read"
    ],
    "rate_tier": "partner",
    "environment": "live",
    "owner": {
      "display_name": "Gallatin River Outfitters"
    }
  },
  "meta": {
    "request_id": "req_9f2c1a7b3e4d5c6f"
  }
}