Skip to main content
GET
/
v1
/
alarms
/
points
/
get-by-id
/
{registrationId}
Get registration by ID
curl --request GET \
  --url https://api.iklim.co/v1/alarms/points/get-by-id/{registrationId}
{
  "registrationId": "f7587d9e-2481-4b4c-818d-c8d1946851b7",
  "recipientId": "Recipient1",
  "boundary": {
    "point": {
      "lat": 39.9208,
      "lng": 32.8541
    },
    "radius": 10000
  },
  "webhook": {
    "accountId": "2f04f1b5-1c0a-4c4e-b0a7-0ba6e9b7f2e1",
    "url": "https://api.customer.com/alerts/callback",
    "httpMethod": "POST",
    "contentType": "application/json",
    "authentication": {
      "username": "alert-user",
      "password": "******"
    },
    "deliveryPolicy": {
      "timeout": 5000,
      "maxRetries": 3,
      "retryDelay": 10
    }
  },
  "filter": {
    "lightning": {
      "type": "FLASH_CLOUD_TO_GROUND",
      "peakCurrent": -12.5,
      "inCloudHeight": 4500
    },
    "thunderstorm": {
      "intersectsAffectedPolygon": true,
      "intersectsCellPolygon": false,
      "severityThreshold": "MEDIUM",
      "speedThreshold": 20
    },
    "precipitation": {
      "types": [
        "RAIN",
        "SNOW"
      ],
      "intensity": 2
    }
  },
  "createdAt": "2025-06-25T11:15:41Z",
  "updatedAt": "2025-06-30T10:05:12Z"
}

Path Parameters

registrationId
string
required

Response

Registration returned successfully

registrationId
string<uuid>

Existing registration UUID. Omit for create; required for update.

Example:

"f7587d9e-2481-4b4c-818d-c8d1946851b7"

recipientId
string

Recipient identifier

Example:

"Recipient1"

boundary
object

Geospatial boundary definition for the alarm (point+radius)

webhook
object

Outbound callback configuration for alarm notifications.

filter
object

Event filters to apply (lightning, thunderstorm, precipitation)

createdAt
string<date-time>

Creation timestamp (UTC)

Example:

"2025-06-25T11:15:41Z"

updatedAt
string<date-time>

Last update timestamp (UTC)

Example:

"2025-06-30T10:05:12Z"