GET
/
subscriptions
/
{external_id}
/
alerts
curl --request GET \
  --url https://api.getlago.com/api/v1/subscriptions/{external_id}/alerts \
  --header 'Authorization: Bearer <token>'
{
  "alerts": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "subscription_external_id": "sub_1234567890",
      "billable_metric_code": "storage_usage",
      "alert_type": "billable_metric_current_usage_amount",
      "code": "storage_threshold_alert",
      "name": "Storage Usage Alert",
      "previous_value": 1000,
      "last_processed_at": "2025-05-19T10:04:21Z",
      "thresholds": [
        {
          "code": "warn",
          "recurring": false,
          "value": "99.0"
        }
      ],
      "created_at": "2025-03-20T10:00:00Z"
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 4,
    "total_count": 70
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

external_id
string
required

External ID of the existing subscription

Example:

"5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"

Response

200
application/json

Subscription alerts

The response is of type object.