{
  "info": {
    "name": "thirdtrail.life API",
    "description": "REST APIs for precision astronomy and ocean data: **Ephemerides** (sun/moon rise, set, twilight), **Solar** (position + irradiance), **Tides** (FES2022 tide predictions), plus two demo products (Echo, Hash).\n\n## Authentication\nEvery `/v1/` endpoint requires an API key sent as a Bearer token:\n\n```\nAuthorization: Bearer tt_live_…\n```\n\nKeys are minted per subscription at https://thirdtrail.life (Dashboard → API keys) and are shown **once** at creation. A key only works for the product it was minted for — an Ephemerides key cannot call `/v1/tides/…`.\n\nSet the `apiKey` variable in your environment (see the bundled *thirdtrail* environment) and requests inherit it collection-wide.\n\n## Plans & gating\nEach product has Free / paid tiers with per-plan quotas (daily/monthly call caps) and feature gates (window length, sampling step, endpoints). Over-quota returns `429`; a feature your plan lacks returns `403` with a human-readable `detail`. Pricing: https://thirdtrail.life/pricing/\n\n## Conventions\n- All timestamps are ISO-8601; pass `tz` (IANA name) or `utc_offset` to localise output, or `auto_timezone=true` (plan-gated) to derive it from the coordinates.\n- Validation errors return `400` with `{\"detail\": \"…\"}`.\n- Deterministic responses for fully-past windows carry `Cache-Control: public, immutable` — cache them client-side freely.\n\n## Safety\nAll data is informational only — **not** for navigation, flight planning, or safety-of-life use. Tide heights are astronomical (FES2022 model) and exclude weather surge. Every data response carries a `notice` object. See https://thirdtrail.life/safety\n\n## Attribution\nTide data: FES2022 was produced by LEGOS, NOVELTIS and CLS, funded by CNES, distributed by AVISO. Astronomy: JPL DE421 ephemeris.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{apiKey}}", "type": "string" }]
  },
  "variable": [
    { "key": "baseUrl", "value": "https://thirdtrail.life", "type": "string" }
  ],
  "item": [
    {
      "name": "Tides (FES2022)",
      "description": "Astronomical tide for **any coastal or offshore point on Earth** — no station lookup. Computed from the FES2022 global tide atlas (34 constituents, 1/30° grid); any date works, past or future.\n\nTiers: **Free** (2-day window, 30-min step) · **Starter €6** (7-day, 10-min, history, coastal window) · **Pro €19** (31-day, 1-min, constituents, LAT datum, bulk×100) · **Business €79** (92-day, bulk×1000).\n\nHeights are metres relative to **MSL** (or LAT with `datum=lat`, Pro+). No surge — see the `notice` field. Docs: https://thirdtrail.life/docs/tides/",
      "item": [
        {
          "name": "Water heights (time series)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/tides/heights/?lat=48.383&lon=-4.495&days=2&step=30m",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "tides", "heights", ""],
              "query": [
                { "key": "lat", "value": "48.383", "description": "REQUIRED. Latitude, decimal degrees [-90, 90]." },
                { "key": "lon", "value": "-4.495", "description": "REQUIRED. Longitude, decimal degrees [-180, 180]." },
                { "key": "days", "value": "2", "description": "Window length in days. Plan-capped: Free 2 / Starter 7 / Pro 31 / Business 92." },
                { "key": "step", "value": "30m", "description": "Sampling step: 1m, 5m, 10m, 15m, 30m, 1h. Finest allowed: Free 30m / Starter 10m / Pro+ 1m. Defaults to the finest your plan allows (max 10m)." },
                { "key": "start_date", "value": "2026-08-01", "description": "YYYY-MM-DD, default today (UTC). Past dates require a paid plan (allow_historical).", "disabled": true },
                { "key": "datum", "value": "msl", "description": "msl (default) or lat = Lowest Astronomical Tide (Pro+). With lat, the response also carries LAT/HAT/MHWS/MLWS offsets from MSL.", "disabled": true },
                { "key": "tz", "value": "Europe/Paris", "description": "IANA timezone for output timestamps. Mutually exclusive with utc_offset.", "disabled": true },
                { "key": "utc_offset", "value": "+02:00", "description": "Fixed offset for output timestamps. Mutually exclusive with tz.", "disabled": true },
                { "key": "auto_timezone", "value": "true", "description": "Derive timezone from lat/lon (Pro+, allow_auto_timezone).", "disabled": true }
              ]
            },
            "description": "Water-height time series at a regular step.\n\n**Gating:** `days` ≤ plan `max_days_per_request`; `step` ≥ plan `min_step_minutes`; total samples ≤ plan `max_points_per_request` (Free 200 / Starter 2 000 / Pro 10 000 / Business 25 000).\n\n**Errors:** `400` inland point or validation, `403` plan gate, `429` over quota, `503` tide data not provisioned.\n\nFully-past windows return `Cache-Control: public, immutable`."
          },
          "response": [
            {
              "name": "200 — two days of heights at Brest",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tides/heights/?lat=48.383&lon=-4.495&days=2&step=30m",
                  "host": ["{{baseUrl}}"],
                  "path": ["v1", "tides", "heights", ""],
                  "query": [
                    { "key": "lat", "value": "48.383" },
                    { "key": "lon", "value": "-4.495" },
                    { "key": "days", "value": "2" },
                    { "key": "step", "value": "30m" }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\n  \"notice\": {\n    \"text\": \"Informational only; not for navigation or safety-of-life use. Heights are astronomical tide (FES2022 model) relative to mean sea level and exclude weather-driven surge. They are model output, not official tide tables.\",\n    \"url\": \"https://thirdtrail.life/safety\"\n  },\n  \"request\": {\n    \"lat\": 48.383, \"lon\": -4.495,\n    \"start_date\": \"2026-07-25\", \"days\": 2, \"step\": \"30m\",\n    \"datum\": \"msl\", \"tz\": null, \"utc_offset\": null, \"auto_timezone\": false\n  },\n  \"resolved\": {\n    \"model\": \"FES2022B\",\n    \"timezone\": \"UTC\", \"timezone_source\": \"default\",\n    \"datum\": \"MSL\", \"plan\": \"starter\"\n  },\n  \"heights\": [\n    { \"time\": \"2026-07-25T00:00:00+00:00\", \"height_m\": 1.062 },\n    { \"time\": \"2026-07-25T00:30:00+00:00\", \"height_m\": 1.147 },\n    { \"time\": \"2026-07-25T01:00:00+00:00\", \"height_m\": 1.05 }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Extremes (high/low waters)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/tides/extremes/?lat=48.383&lon=-4.495&days=2",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "tides", "extremes", ""],
              "query": [
                { "key": "lat", "value": "48.383", "description": "REQUIRED. Latitude [-90, 90]." },
                { "key": "lon", "value": "-4.495", "description": "REQUIRED. Longitude [-180, 180]." },
                { "key": "days", "value": "2", "description": "Window length in days (plan-capped, same as /heights/)." },
                { "key": "start_date", "value": "2026-08-01", "description": "YYYY-MM-DD, default today (UTC). Past requires paid plan.", "disabled": true },
                { "key": "datum", "value": "lat", "description": "msl (default) or lat (Pro+).", "disabled": true },
                { "key": "tz", "value": "Europe/Paris", "description": "IANA timezone for output.", "disabled": true }
              ]
            },
            "description": "High and low waters (times refined to ~1 s via parabolic interpolation, heights in metres).\n\nSame parameters and gating as `/heights/`, minus `step`."
          },
          "response": [
            {
              "name": "200 — highs/lows at Brest",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tides/extremes/?lat=48.383&lon=-4.495&days=1",
                  "host": ["{{baseUrl}}"],
                  "path": ["v1", "tides", "extremes", ""],
                  "query": [
                    { "key": "lat", "value": "48.383" },
                    { "key": "lon", "value": "-4.495" },
                    { "key": "days", "value": "1" }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\n  \"notice\": { \"text\": \"Informational only; …\", \"url\": \"https://thirdtrail.life/safety\" },\n  \"request\": { \"lat\": 48.383, \"lon\": -4.495, \"start_date\": \"2026-07-25\", \"days\": 1, \"datum\": \"msl\", \"tz\": null, \"utc_offset\": null, \"auto_timezone\": false },\n  \"resolved\": { \"model\": \"FES2022B\", \"timezone\": \"UTC\", \"timezone_source\": \"default\", \"datum\": \"MSL\", \"plan\": \"starter\" },\n  \"extremes\": [\n    { \"type\": \"high\", \"time\": \"2026-07-25T00:12:19+00:00\", \"height_m\": 1.148 },\n    { \"type\": \"low\",  \"time\": \"2026-07-25T06:34:38+00:00\", \"height_m\": -1.352 },\n    { \"type\": \"high\", \"time\": \"2026-07-25T12:46:18+00:00\", \"height_m\": 1.373 },\n    { \"type\": \"low\",  \"time\": \"2026-07-25T19:10:49+00:00\", \"height_m\": -1.492 }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Harmonic constituents (Pro+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/tides/constituents/?lat=48.383&lon=-4.495",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "tides", "constituents", ""],
              "query": [
                { "key": "lat", "value": "48.383", "description": "REQUIRED. Latitude [-90, 90]." },
                { "key": "lon", "value": "-4.495", "description": "REQUIRED. Longitude [-180, 180]." }
              ]
            },
            "description": "The 34 FES2022 harmonic constants interpolated at your point, sorted by amplitude: constituent name, amplitude (m), **Greenwich phase lag** (°), angular speed (°/hour).\n\nUse them to run your own synthesis offline or cross-check our numbers.\n\n**Requires Pro or higher** (`allow_constituents`); otherwise `403`."
          },
          "response": [
            {
              "name": "200 — top of the table at Brest",
              "originalRequest": {
                "method": "GET",
                "header": [],
                "url": {
                  "raw": "{{baseUrl}}/v1/tides/constituents/?lat=48.383&lon=-4.495",
                  "host": ["{{baseUrl}}"],
                  "path": ["v1", "tides", "constituents", ""],
                  "query": [
                    { "key": "lat", "value": "48.383" },
                    { "key": "lon", "value": "-4.495" }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [{ "key": "Content-Type", "value": "application/json" }],
              "body": "{\n  \"notice\": { \"text\": \"Informational only; …\", \"url\": \"https://thirdtrail.life/safety\" },\n  \"request\": { \"lat\": 48.383, \"lon\": -4.495 },\n  \"resolved\": { \"model\": \"FES2022B\", \"n_constituents\": 34, \"phase_convention\": \"Greenwich phase lag (degrees)\", \"plan\": \"pro\" },\n  \"constituents\": [\n    { \"constituent\": \"M2\", \"amplitude_m\": 2.188, \"phase_deg\": 100.53, \"speed_deg_per_hour\": 28.9841042 },\n    { \"constituent\": \"S2\", \"amplitude_m\": 0.812, \"phase_deg\": 138.78, \"speed_deg_per_hour\": 30.0 },\n    { \"constituent\": \"N2\", \"amplitude_m\": 0.431, \"phase_deg\": 82.24, \"speed_deg_per_hour\": 28.4397295 }\n  ]\n}"
            }
          ]
        },
        {
          "name": "Coastal window — tide + sun/moon (Starter+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/tides/window/?lat=48.383&lon=-4.495&days=3",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "tides", "window", ""],
              "query": [
                { "key": "lat", "value": "48.383", "description": "REQUIRED. Latitude [-90, 90]." },
                { "key": "lon", "value": "-4.495", "description": "REQUIRED. Longitude [-180, 180]." },
                { "key": "days", "value": "3", "description": "Window length in days (plan-capped)." },
                { "key": "start_date", "value": "2026-08-01", "description": "YYYY-MM-DD, default today.", "disabled": true },
                { "key": "datum", "value": "msl", "description": "msl (default) or lat (Pro+).", "disabled": true },
                { "key": "tz", "value": "Europe/Paris", "description": "IANA timezone for output.", "disabled": true },
                { "key": "elevation", "value": "214", "description": "Observer elevation in metres above sea level, −500 to 9000. Applies to the sun and moon times only; tide heights are unaffected.", "disabled": true },
                { "key": "auto_elevation", "value": "true", "description": "Pro+. Derive the observer's elevation from lat / lon instead of passing elevation.", "disabled": true }
              ]
            },
            "description": "The coastal planning call, unique to thirdtrail: per day, tide highs/lows **plus** sunrise/sunset, twilight, golden/blue hour and moon phase from the Ephemerides engine — one request instead of two products.\n\nBuilt for photographers, anglers, drone pilots and shore crews.\n\n**Requires Starter or higher** (`allow_coastal_window`)."
          },
          "response": []
        },
        {
          "name": "Bulk extremes (Pro+)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/v1/tides/bulk/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "tides", "bulk", ""]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"queries\": [\n    { \"lat\": 48.383, \"lon\": -4.495, \"days\": 1 },\n    { \"lat\": 51.507, \"lon\": 1.0, \"days\": 1, \"start_date\": \"2026-08-01\" },\n    { \"lat\": -33.856, \"lon\": 151.215, \"days\": 2 }\n  ]\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "High/low waters for many locations in one request. Each query: `lat`, `lon` (required), `days` (≤ plan window), `start_date` (optional; past requires `allow_historical`).\n\nPer-item failures (e.g. an inland point) return an `error` on that item — the batch never fails as a whole. Each item counts once against your quota.\n\n**Limits:** Pro ≤ 100 queries/request, Business ≤ 1 000. `403` below Pro."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Ephemerides",
      "description": "Sun + moon rise/set/transit, twilight phases, golden/blue hour and moon phase for any lat/lon **and elevation** — elevation correction is unique among ephemerides APIs.\n\nTiers: Free / Starter €9 / Pro €39 / Business €149. Feature gates: twilight & transit (Starter+), localisation + bulk (Pro+), auto-elevation/timezone (Business). Docs: https://thirdtrail.life/docs/ephemerides/",
      "item": [
        {
          "name": "Daily ephemerides",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/?lat=46.2&lon=6.15&days=7",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", ""],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED. Latitude [-90, 90]." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED. Longitude [-180, 180]." },
                { "key": "days", "value": "7", "description": "Days to compute (plan-capped: Free 7 / Starter 30 / Pro 90 / Business 365)." },
                { "key": "elevation", "value": "375", "description": "Observer elevation in metres [-500, 9000]. Applies horizon-dip correction.", "disabled": true },
                { "key": "start_date", "value": "2026-08-01", "description": "YYYY-MM-DD. Past dates require paid plan.", "disabled": true },
                { "key": "tz", "value": "Europe/Zurich", "description": "IANA timezone for output.", "disabled": true },
                { "key": "utc_offset", "value": "+01:00", "description": "Fixed offset alternative to tz.", "disabled": true },
                { "key": "auto_elevation", "value": "true", "description": "Derive elevation from lat/lon (Business+).", "disabled": true },
                { "key": "auto_timezone", "value": "true", "description": "Derive timezone from lat/lon (Business+).", "disabled": true },
                { "key": "lang", "value": "fr", "description": "Localised moon-phase names (Pro+).", "disabled": true }
              ]
            },
            "description": "Per-day sun/moon events. Twilight (civil/nautical/astronomical), transit times and golden/blue-hour windows are included when your plan allows them — features your plan lacks are **silently omitted**, the call still succeeds.\n\n⚠️ Times are elevation-corrected — they intentionally differ from official almanac times. Not for aviation/marine legal timing (see `notice`)."
          },
          "response": []
        },
        {
          "name": "Prayer times (Starter+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/prayer-times/?lat=21.42&lon=39.83&school=mwl",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "prayer-times", ""],
              "query": [
                { "key": "lat", "value": "21.42", "description": "REQUIRED. Latitude." },
                { "key": "lon", "value": "39.83", "description": "REQUIRED. Longitude." },
                { "key": "school", "value": "mwl", "description": "REQUIRED. Calculation school — the error message lists all accepted values." },
                { "key": "asr_method", "value": "shafi", "description": "shafi (default) or hanafi.", "disabled": true },
                { "key": "date", "value": "2026-08-01", "description": "YYYY-MM-DD, default today. Past requires paid plan.", "disabled": true },
                { "key": "elevation", "value": "300", "description": "Observer elevation (m).", "disabled": true },
                { "key": "tz", "value": "Asia/Riyadh", "description": "IANA timezone for output.", "disabled": true }
              ]
            },
            "description": "Five daily Islamic prayer times with selectable calculation school and Asr juristic method. Twilight-angle-dependent, so it requires the same plan flag as twilight (**Starter+**)."
          },
          "response": []
        },
        {
          "name": "Bulk (Pro+)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/bulk/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "bulk", ""]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"queries\": [\n    { \"lat\": 46.2, \"lon\": 6.15, \"days\": 3 },\n    { \"lat\": 35.68, \"lon\": 139.69, \"days\": 3, \"elevation\": 40, \"tz\": \"Asia/Tokyo\" }\n  ]\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Up to `max_bulk_size` (Pro 100 / Business 1 000) independent queries in one request; each counts once against quota. Per-item errors never fail the batch."
          },
          "response": []
        },
        {
          "name": "iCal feed (Starter+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/feed.ics?lat=46.2&lon=6.15&events=sunrise,sunset",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "feed.ics"],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED. Latitude." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED. Longitude." },
                { "key": "events", "value": "sunrise,sunset", "description": "Comma-separated event tokens (sunrise, sunset, twilight and golden/blue-hour tokens are plan-gated; unknown tokens 400)." },
                { "key": "days", "value": "14", "description": "Horizon in days (plan-capped).", "disabled": true }
              ]
            },
            "description": "RFC 5545 calendar feed (`text/calendar`) of upcoming events — subscribe from any calendar app; clients poll and stay current. Deterministic UIDs allow client-side dedupe. **Starter+** (`allow_ical_feed`)."
          },
          "response": []
        },
        {
          "name": "Webhooks — list",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/webhooks/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "webhooks", ""]
            },
            "description": "List your webhook subscriptions for this product. **Pro+** (`allow_webhooks`)."
          },
          "response": []
        },
        {
          "name": "Webhooks — create (Pro+)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/webhooks/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "webhooks", ""]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_type\": \"sunrise\",\n  \"lat\": 46.2,\n  \"lon\": 6.15,\n  \"callback_url\": \"https://example.com/hooks/sunrise\",\n  \"elevation\": 375,\n  \"horizon_days\": 30\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Create an event-time webhook: we POST to `callback_url` when the event occurs at the location.\n\n**Fields:** `event_type` (one of `sunrise`, `sunset`, `civil_dawn`, `civil_dusk`, `solar_noon`, `moonrise`, `moonset`), `lat`, `lon`, `callback_url` (http/https) — all required; `elevation` m (default 0), `horizon_days` 1–365 (default 30).\n\n⚠️ The response includes the signing `secret` **once, at creation only** — store it; deliveries are HMAC-signed with it. Webhook payload contract: https://thirdtrail.life/docs/webhooks/"
          },
          "response": []
        },
        {
          "name": "Webhooks — get one",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/webhooks/:webhook_id/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "webhooks", ":webhook_id", ""],
              "variable": [{ "key": "webhook_id", "value": "", "description": "Webhook UUID from the create/list response." }]
            },
            "description": "Fetch one webhook subscription (never returns the secret)."
          },
          "response": []
        },
        {
          "name": "Webhooks — delete",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/ephemerides/webhooks/:webhook_id/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "ephemerides", "webhooks", ":webhook_id", ""],
              "variable": [{ "key": "webhook_id", "value": "", "description": "Webhook UUID." }]
            },
            "description": "Delete a webhook subscription. Returns `204`."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Solar",
      "description": "Precision solar geometry backed by JPL DE421: position (azimuth/altitude/zenith), declination, hour angle, equation of time, air mass — plus Bird clear-sky irradiance and Daily Light Integral.\n\nTiers: Free / Developer €19 / Pro €79 / Business €299. Docs: https://thirdtrail.life/docs/solar/",
      "item": [
        {
          "name": "Position (single instant)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/?lat=46.2&lon=6.15",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", ""],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED. Latitude [-90, 90]." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED. Longitude [-180, 180]." },
                { "key": "timestamp", "value": "2026-06-21T12:00:00Z", "description": "ISO-8601 with timezone; default now. Past gated by allow_historical + max_historical_years; future by max_forecast_days.", "disabled": true },
                { "key": "elevation", "value": "375", "description": "Observer elevation (m) — first-class input, affects air mass & irradiance.", "disabled": true },
                { "key": "include", "value": "position,irradiance", "description": "Comma list: position (always), irradiance (Developer+). Unknown tokens 400; un-entitled tokens silently ignored.", "disabled": true },
                { "key": "broadband_aod", "value": "0.084", "description": "Aerosol optical depth override for the irradiance model (Pro+).", "disabled": true },
                { "key": "water_cm", "value": "1.5", "description": "Precipitable water (cm), irradiance model.", "disabled": true },
                { "key": "ozone_cm", "value": "0.3", "description": "Ozone column (cm), irradiance model.", "disabled": true },
                { "key": "ground_albedo", "value": "0.2", "description": "Ground albedo [0,1], irradiance model.", "disabled": true }
              ]
            },
            "description": "Solar position at one instant. Optional `include=irradiance` adds Bird clear-sky GHI/DNI/DHI (Developer+)."
          },
          "response": []
        },
        {
          "name": "Range (time series, Developer+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/range/?lat=46.2&lon=6.15&from=2026-08-01T06:00:00Z&to=2026-08-01T20:00:00Z&interval=15m",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", "range", ""],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED." },
                { "key": "from", "value": "2026-08-01T06:00:00Z", "description": "REQUIRED. ISO-8601 with timezone." },
                { "key": "to", "value": "2026-08-01T20:00:00Z", "description": "REQUIRED. ISO-8601, must be > from." },
                { "key": "interval", "value": "15m", "description": "1m, 5m, 15m, 1h or 1d. Sample count capped per plan (Free 96 / Developer 1 000 / Pro 10 000 / Business 100 000)." },
                { "key": "include", "value": "position,irradiance", "description": "irradiance adds clear-sky values per sample.", "disabled": true },
                { "key": "elevation", "value": "375", "description": "Observer elevation (m).", "disabled": true }
              ]
            },
            "description": "Sun position (and optional irradiance) sampled at a regular interval. **Developer+** (`allow_sun_path`)."
          },
          "response": []
        },
        {
          "name": "Sun path for a date (Developer+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/path/?lat=46.2&lon=6.15&date=2026-08-01&interval=15m",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", "path", ""],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED." },
                { "key": "date", "value": "2026-08-01", "description": "YYYY-MM-DD, default today (UTC day boundaries)." },
                { "key": "interval", "value": "15m", "description": "1m, 5m, 15m, 1h, 1d.", "disabled": true },
                { "key": "elevation", "value": "375", "description": "Observer elevation (m).", "disabled": true }
              ]
            },
            "description": "Azimuth/altitude arrays for one date — the sun-path diagram feed. Convenience wrapper over /range/. **Developer+**."
          },
          "response": []
        },
        {
          "name": "Daily Light Integral (Developer+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/dli/?lat=46.2&lon=6.15&date=2026-08-01",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", "dli", ""],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED." },
                { "key": "date", "value": "2026-08-01", "description": "Single date — or use from/to instead." },
                { "key": "from", "value": "2026-08-01", "description": "Range start (with to).", "disabled": true },
                { "key": "to", "value": "2026-08-07", "description": "Range end.", "disabled": true },
                { "key": "elevation", "value": "375", "description": "Observer elevation (m).", "disabled": true }
              ]
            },
            "description": "DLI in mol·m⁻²·day⁻¹ — clear-sky GHI integrated sunrise→sunset at 5-min steps, PAR factor 0.45 (Mavi 2004). The agronomy/greenhouse metric. **Developer+** (`include_dli`)."
          },
          "response": []
        },
        {
          "name": "Bulk (Pro+)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/bulk/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", "bulk", ""]
            },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"queries\": [\n    { \"lat\": 46.2, \"lon\": 6.15, \"timestamp\": \"2026-08-01T12:00:00Z\" },\n    { \"lat\": -33.86, \"lon\": 151.21, \"elevation\": 58 }\n  ]\n}",
              "options": { "raw": { "language": "json" } }
            },
            "description": "Solar position for many instants/locations in one call; irradiance included when the plan allows. **Pro+**, `max_bulk_size` per plan."
          },
          "response": []
        },
        {
          "name": "iCal feed (Developer+)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/feed.ics?lat=46.2&lon=6.15&events=solar_noon",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", "feed.ics"],
              "query": [
                { "key": "lat", "value": "46.2", "description": "REQUIRED." },
                { "key": "lon", "value": "6.15", "description": "REQUIRED." },
                { "key": "events", "value": "solar_noon", "description": "solar_noon and/or dli (dli requires include_dli)." },
                { "key": "horizon", "value": "30", "description": "Days ahead (plan-capped).", "disabled": true }
              ]
            },
            "description": "Calendar subscription for solar events (`text/calendar`). **Developer+**."
          },
          "response": []
        },
        {
          "name": "Webhooks — list / create / manage",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/solar/webhooks/",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "solar", "webhooks", ""]
            },
            "description": "Identical contract to the Ephemerides webhooks (same event types, fields and one-time secret): `GET/POST /v1/solar/webhooks/`, `GET/DELETE /v1/solar/webhooks/{uuid}/`. **Pro+**. See the Ephemerides folder for the documented create payload."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Demo — Echo & Hash",
      "description": "Two trivial products for trying out the marketplace auth/quota flow end-to-end. Each needs its own product key.",
      "item": [
        {
          "name": "Echo",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/echo/?msg=hello",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "echo", ""],
              "query": [
                { "key": "msg", "value": "hello", "description": "Message to echo back." }
              ]
            },
            "description": "Echoes `msg` with its length, the server time and the calling account's email."
          },
          "response": []
        },
        {
          "name": "Hash",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/v1/hash/?text=hello",
              "host": ["{{baseUrl}}"],
              "path": ["v1", "hash", ""],
              "query": [
                { "key": "text", "value": "hello", "description": "Text to hash." }
              ]
            },
            "description": "Returns the SHA-256 digest of `text`."
          },
          "response": []
        }
      ]
    }
  ]
}
