Skip to main content
GET
/
forecast
/
{id}
Get weather forecast for a location
curl --request GET \
  --url http://pinpoint.devops.arabiaweather.com/forecast/{id}
{
  "locations": [
    {
      "id": "<string>",
      "info": {
        "name": {
          "en": "<string>",
          "ar": "<string>"
        },
        "lat": 123,
        "lng": 123,
        "timezone": "<string>",
        "elevation": 123,
        "countryCode": "<string>",
        "regionId": "<string>"
      },
      "hourly": [
        {
          "time": 123,
          "is_day": true,
          "local_time": "2023-11-07T05:31:56Z",
          "data": {}
        }
      ],
      "daily": [
        {
          "date": "2023-12-25",
          "day_time": {},
          "night_time": {},
          "hijri": {}
        }
      ],
      "segments": [
        {}
      ]
    }
  ]
}

Path Parameters

​
id
string
required

Location ID or comma-separated list of location IDs

Query Parameters

​
start
string
default:now

Start time for the forecast (e.g., 'now', 'today', or ISO date string)

​
interval
integer
default:24

Forecast interval in hours

​
parameters
string

Comma-separated list of weather parameters to include (e.g., 'surface.visibility,surface.temperature')

​
hourly
boolean
default:true

Whether to include hourly forecasts

​
hijri
boolean
default:false

Whether to include Hijri date information

​
overrides
boolean
default:true

Whether to apply overrides to the forecast data

​
info
boolean
default:false

Whether to include location information

​
cache
boolean
default:true

Whether to use the current cache if available (default: true). Setting cache=false will invalidate the cache and return fresh data.

​
segments
enum<string>
default:false

Segmented overview mode ('true', 'false', 'day', '3hrs', '6hrs')

Available options:
true,
false,
day,
3hrs,
6hrs
​
daily
boolean
default:true

Whether to include daily forecast overview

​
model
string
default:default

Weather model to use

​
timezone
string

Timezone to use for the forecast (if not specified, uses location's timezone)

​
consumer_warning
boolean
default:false

Whether to include consumer warnings

​
status_details
string

Comma-separated list of status details to include

Response

Weather forecast data

​
locations
object[]