Get all threshold notifications

curl --request POST \
  --url https://api.metronome.com/v1/customer-alerts/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customer_id": "9b85c1c1-5238-4f2a-a409-61412905e1e1"
}'

{
  "data": [
    {
      "customer_status": "in_alarm",
      "alert": {
        "id": "8deed800-1b7a-495d-a207-6c52bac54dc9",
        "name": "Low credit balance alert",
        "uniqueness_key": "823j7fqzo1",
        "type": "low_credit_balance_reached",
        "status": "enabled",
        "credit_type": {
          "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "name": "USD (cents)"
        },
        "threshold": 0,
        "updated_at": "2022-01-01T00:00:00Z"
      }
    },
    {
      "customer_status": "ok",
      "alert": {
        "id": "3d45fdc3-e237-4acd-a7d9-ccfeb40e71b8",
        "name": "Spend threshold alert",
        "type": "spend_threshold_reached",
        "status": "enabled",
        "credit_type": {
          "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "name": "USD (cents)"
        },
        "threshold": 1000,
        "updated_at": "2022-01-01T00:00:00Z"
      }
    }
  ],
  "next_page": null
}

Notifications

Get all threshold notifications

Retrieve all threshold notification configurations and their current statuses for a specific customer in a single API call. This endpoint provides a comprehensive view of all threshold notification monitoring a customer account.

Use this endpoint to:

Display all active threshold notifications for a customer in dashboards or admin panels
Quickly identify which threshold notifications a customer is currently triggering
Audit threshold notification coverage for specific accounts
Filter threshold notifications by status (enabled, disabled, or archived)

Key response fields:

data: Array of CustomerAlert objects, each containing:
- Current evaluation status (ok, in_alarm, evaluating, or null)
- Complete threshold notification configuration and threshold details
- Threshold notification metadata including type, name, and last update time
next_page: Pagination cursor for retrieving additional results

Usage guidelines:

Default behavior: Returns only enabled threshold notifications unless alert_statuses filter is specified
Pagination: Use the next_page cursor to retrieve all results for customers with many notifications
Performance: Efficiently retrieves multiple threshold notification statuses in a single request instead of making individual calls
Filtering: Pass the alert_statuses array to include disabled or archived threshold notifications in results

POST

customer-alerts

list

Get all threshold notifications

curl --request POST \
  --url https://api.metronome.com/v1/customer-alerts/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customer_id": "9b85c1c1-5238-4f2a-a409-61412905e1e1"
}'

{
  "data": [
    {
      "customer_status": "in_alarm",
      "alert": {
        "id": "8deed800-1b7a-495d-a207-6c52bac54dc9",
        "name": "Low credit balance alert",
        "uniqueness_key": "823j7fqzo1",
        "type": "low_credit_balance_reached",
        "status": "enabled",
        "credit_type": {
          "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "name": "USD (cents)"
        },
        "threshold": 0,
        "updated_at": "2022-01-01T00:00:00Z"
      }
    },
    {
      "customer_status": "ok",
      "alert": {
        "id": "3d45fdc3-e237-4acd-a7d9-ccfeb40e71b8",
        "name": "Spend threshold alert",
        "type": "spend_threshold_reached",
        "status": "enabled",
        "credit_type": {
          "id": "2714e483-4ff1-48e4-9e25-ac732e8f24f2",
          "name": "USD (cents)"
        },
        "threshold": 1000,
        "updated_at": "2022-01-01T00:00:00Z"
      }
    }
  ],
  "next_page": null
}

Authorizations

Authorization

string

header

required

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

Query Parameters

next_page

string

Cursor that indicates where the next page of results should start.

Body

application/json

The threshold notifications query to run

customer_id

string<uuid>

required

The Metronome ID of the customer

alert_statuses

enum<string>[]

Optionally filter by threshold notification status. If absent, only enabled notifications will be returned.

Minimum length: 1

Show child attributes

Response

200 - application/json

Success

data

object[]

required

Show child attributes

next_page

string | null

required

Get a threshold notification

Reset a threshold notification

GET STARTED

API REFERENCE

Get all threshold notifications

Use this endpoint to:

Key response fields:

Usage guidelines:

Authorizations

Query Parameters

Body

Response