Nowcast API 0.28.7

The Nowcast API provides access to minute-by-minute precipitation forecast for the next 4 hours.

---

Servers

Description	URL
Production API server	https://api.rainbow.ai

Endpoints

---

GET /nowcast/v1/precip/{longitude}/{latitude}

Minute-by-minute precipitation forecast

Description

This endpoint provides a minute-by-minute precipitation forecast for the next 4 hours.

The forecast includes:

• Minute-by-minute precipitation for the next 4 hours.

Use Cases

• Weather apps providing detailed short-term forecasts

• Logistics & transportation companies planning routes

• Outdoor activity planning, such as hiking, sports, and events

Data Coverage

• The API supports global locations but may return 404 if weather data is unavailable in a specific area.

Input parameters

Parameter	In	Type	Default	Nullable	Description
latitude	path	number		No	Latitude coordinate of the location for which the forecast is requested
longitude	path	number		No	Longitude coordinate of the location for which the forecast is requested
start_timestamp	query	None		No	Start timestamp of the forecast (in seconds). This timestamp could be only in a past 30 minutes. It must be less that current time and aligned to 1-minute intervals.If not provided, the current time will be used.

Response 200 OK

application/json

JSON

{
    "forecast": [
        {
            "precipRate": 1.42,
            "precipType": "snow",
            "timestampBegin": 1737570600,
            "timestampEnd": 1737570660
        }
    ],
    "latitude": 52.23289409654632,
    "longitude": 21.0065536398819,
    "summary": {
        "intensity": "moderate"
    }
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "longitude": {
            "type": "number",
            "title": "longitude",
            "description": "Longitude coordinate of the location for which the forecast is prepared",
            "example": 21.0065536398819
        },
        "latitude": {
            "type": "number",
            "title": "latitude",
            "description": "Latitude coordinate of the location for which the forecast is prepared",
            "example": 52.23289409654632
        },
        "summary": {
            "$ref": "#/components/schemas/PrecipForecastSummary",
            "title": "summary",
            "description": "Classification of the maximum precipitation intensity during the period"
        },
        "forecast": {
            "items": {
                "$ref": "#/components/schemas/PrecipForecastItem"
            },
            "type": "array",
            "title": "forecast",
            "description": "Precipitation forecast for the next 4 hours"
        }
    },
    "type": "object",
    "required": [
        "longitude",
        "latitude",
        "summary",
        "forecast"
    ],
    "title": "PrecipForecastResponse",
    "example": {
        "forecast": [
            {
                "precipRate": 1.42,
                "precipType": "snow",
                "timestampBegin": 1737570600,
                "timestampEnd": 1737570660
            }
        ],
        "latitude": 52.23289409654632,
        "longitude": 21.0065536398819,
        "summary": {
            "intensity": "moderate"
        }
    }
}

Response 400 Bad Request

application/json

JSON

{
    "message": "string"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "message": {
            "title": "Message",
            "type": "string"
        }
    },
    "required": [
        "message"
    ],
    "title": "ResponseError",
    "type": "object"
}

Response 404 Not Found

Response 422 Unprocessable Entity

application/json

JSON

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

JSON

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

Schemas

HTTPValidationError

Name	Type
detail	Array<ValidationError>

PrecipForecastItem

Name	Type
precipRate	number
precipType	ResponsePrecipType
timestampBegin	integer
timestampEnd	integer

PrecipForecastResponse

Name	Type
forecast	Array<PrecipForecastItem>
latitude	number
longitude	number
summary	PrecipForecastSummary

PrecipForecastSummary

Name	Type
intensity	ResponsePrecipIntensity

ResponsePrecipIntensity

Type: string

ResponsePrecipType

Type: string

ValidationError

Name	Type
loc	Array<>
msg	string
type	string