Skip to main content
POST
/
v1
/
precipitations
/
page
Page Operation
curl --request POST \
  --url https://api.iklim.co/v1/precipitations/page \
  --header 'Content-Type: application/json' \
  --data '
{
  "backwardInterval": 3600,
  "endTimeEpoch": 1646374400000,
  "intensityThreshold": "MODERATE",
  "pageNumber": 0,
  "pageSize": 10
}
'
{
  "precipitations": [
    {
      "eventId": "6932e0b4d4a02eb8afdf2951",
      "radarTimeStamp": 1646374400000,
      "forecast": false,
      "intensity": "MODERATE"
    }
  ],
  "queryTimestamp": 123,
  "totalRecords": 123,
  "pageNumber": 0,
  "pageSize": 10
}

Body

application/json
backwardInterval
integer<int64>
required

Backward interval in seconds counting back from the end time. Maximum 5 days.

Required range: 60 <= x <= 432000
Example:

3600

endTimeEpoch
integer<int64>
required

Query end time in Epoch milliseconds.

Required range: x >= 0
Example:

1646374400000

intensityThreshold
enum<string>
required

Precipitation intensity threshold for filtering results.

Available options:
DRIZZLE,
LIGHT,
MODERATE,
HEAVY,
VERY_HEAVY,
EXTREME
Example:

"MODERATE"

pageNumber
integer<int32>
required

Zero-based page number to fetch from the paged results.

Required range: x >= 0
Example:

0

pageSize
integer<int32>
required

Number of results returned per page.

Required range: x <= 100
Example:

10

Response

Returns a paginated list of precipitation records matching the subscription's geographic boundaries and the specified time range, along with total record count, query timestamp, and current page information.

precipitations
object[]

List of precipitation records matching the query.

queryTimestamp
integer<int64>

The timestamp when the query was executed, in Epoch milliseconds.

totalRecords
integer<int64>

Total number of records found for the given query.

pageNumber
integer<int32>

The current page number of the paginated response.

Example:

0

pageSize
integer<int32>

The number of records returned per page.

Example:

10