---
title: "Retrieve a wallet alert"
method: GET
path: "/customers/{external_customer_id}/wallets/{wallet_code}/alerts/{code}"
tags: ["wallets"]
---

# Retrieve a wallet alert

`GET /customers/{external_customer_id}/wallets/{wallet_code}/alerts/{code}`

This endpoint enables the retrieval of a specific alert for a wallet.

## Response `200`

Wallet alert

- WalletAlert
  - `alert` WalletAlertObject, required
    - `lago_id` string, uuid, required — Unique identifier of the alert, created by Lago.
    - `lago_organization_id` string, uuid, required — Unique identifier of the organization, created by Lago.
    - `external_subscription_id` unknown, required
    - `lago_wallet_id` string — Unique identifier of the wallet, created by Lago.
    - `wallet_code` string — The wallet external unique identifier (provided by your own application).
    - `billable_metric` unknown, required
    - `alert_type` 'wallet_balance_amount' | 'wallet_credits_balance' | 'wallet_ongoing_balance_amount' | 'wallet_credits_ongoing_balance', required — The type of alert.
    - `code` string, required — Unique code used to identify the alert.
    - `name` string, nullable, required — The name of the alert.
    - `direction` 'increasing' | 'decreasing' — Indicates whether the alert is triggered when the monitored metric goes above or below the threshold.
    - `previous_value` number, required — When the system checked if this alert should be triggered, this value was retrieved and checked against the thresholds.
    - `last_processed_at` string, date-time, nullable, required — The date and time in UTC (ISO 8601) when the system checked if this alert should be triggered. Null until it's processed for the first time.
    - `thresholds` AlertThresholdObject[], required — Array of thresholds associated with the alert.
      - `code` string, nullable, required — Unique identifier of the usage threshold created by Lago.
      - `recurring` boolean, required — This field when set to `true` indicates that the alert will be retrigger when this threshold is reached after the last non-recurring threshold. Only one recurring threshold per alert allowed.
      - `value` string, required — A value that should trigger this alert, formatted as a BigDecimal.
    - `created_at` string, date-time, required — The date and time in UTC (ISO 8601) when the alert was created.

## Other responses

- `401` — Unauthorized error
- `404` — Not Found error

---

[API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) · [All operations](https://skmtc.dev/getlago/apis/lago-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getlago/lago-api-documentation/revisions/6e969ef3bb45/schema)