Forge documentation

Forge is a REST API for weather and geolocation data: current conditions, daily forecasts up to 7 days out, and a global geocoder. Everything lives under one base URL and one authentication scheme.

https://forge-api.dev/v1

At a glance

• Two resources. GET /v1/weather for conditions and forecast, GET /v1/geocode to turn place names into coordinates.
• One auth scheme. Every request carries an API key in the Authorization: Bearer header. Keys are minted in the dashboard after signing up (free, no card). See Authentication.
• Enveloped JSON. Successful responses wrap the payload as {"status":"ok","data":{…},"meta":{…}}; errors are {"status":"error","error":{…}}. See Errors.
• Honest rate limits. Every response tells you where you stand via X-RateLimit-* headers. See Rate limits.

Your first request

curl "https://forge-api.dev/v1/weather?lat=51.51&lon=-0.13&units=metric" \
  -H "Authorization: Bearer fg_live_YOUR_KEY"

New here? The quickstart gets you from zero to a live response in about two minutes.