---
title: "Everything for one destination in one call"
method: GET
path: "/api/v1/plan_trip"
tags: ["Free"]
---

# Everything for one destination in one call

`GET /api/v1/plan_trip`

## Request

- Base URL: `https://camp.cosmicotter.ca`
- URL: `https://camp.cosmicotter.ca/api/v1/plan_trip`
- Auth: one of:
  - none
  - HTTP bearer

One call that answers "can I camp at this spot this weekend?": land status and the camping rule, signal per carrier, the 3-day forecast with workable days, wildfires within 60 km, road reports within 10 km, and the best remote spots with signal nearby (top 3 free, 5 with a pass), with the important heads_up lines listed first.

## Query parameters

- `lat` number, required: Latitude in decimal degrees (WGS84).
- `lng` number, required: Longitude in decimal degrees (WGS84), negative west of Greenwich.
- `radius_km` number: Search radius in kilometres (default 40, at most 200).
- `carrier` 'telus' | 'rogers' | 'freedom' | 'sasktel' | 'verizon' | 'att' | 'tmobile' | 'gci' | 'inland': Mobile carrier to rank signal for. Canada: telus (also Bell, Koodo, Virgin), rogers (also Fido), freedom, sasktel. US: verizon, att, tmobile, gci, inland. Defaults to telus in Canada and verizon in the US.
- `access` 'any' | 'rental' | 'drive' | 'rough' | 'hike'
- `tz_offset_min` integer: Minutes from UTC for day boundaries. Default -420.

## Response `200`

Result as JSON

## Other responses

- `400`: Bad input
- `402`: Needs a Camp Map Pass key
- `429`: Rate limited: wait and retry (see Retry-After)

---

[API](https://skmtc.dev/cosmicotter/apis/cosmic-s-camp-map-api.md) · [All operations](https://skmtc.dev/cosmicotter/apis/cosmic-s-camp-map-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cosmicotter/apis/cosmic-s-camp-map-api/revisions/2bd179814574?raw)