List monitoring periods

Signal charges the full agreed monthly rate once per borrower/business/workspace at 00:00 UTC on the first day of the month, before monitoring proceeds. First activation during a month charges the full monthly rate immediately, without proration; the next charge is at the next month boundary. Repeated monitor creation, pauses, resumes, checks and reassessments do not add charges in an already paid period. Insufficient credits block monitoring without a debit or debt; funding resumes only the current period after its single successful charge, without charging missed inactive months. User-paused monitoring remains paused until the user resumes it. Account cancellation stops processing and all further deductions immediately. Read one shared record per subject/month, including its charge and workload references. Periods are immutable in identity; current status and charged_at reflect activation. API reads never create a charge.

GET /v1/monitoring-periods

cURL

cURL

curl --request GET --fail-with-body --max-time 30 \
  "${AMLOK_API_BASE_URL}/v1/monitoring-periods?subject_id=biz_example&limit=100" \
  --header "Authorization: Bearer ${AMLOK_API_KEY}" \
  --header "Accept: application/json"

200

synthetic

{
  "data": [
    {
      "id": "monitoring_period_example",
      "object": "monitoring_period",
      "workspace_id": "wsp_example",
      "subject_id": "biz_example",
      "period_start": "2026-10-01T00:00:00Z",
      "period_end": "2026-11-01T00:00:00Z",
      "first_activated_at": "2026-10-01T00:00:00Z",
      "charged_at": "2026-10-01T00:00:00Z",
      "billing_usage_id": "billing_usage_signal",
      "status": "active",
      "workload_id": "workload_signal_example",
      "baseline_snapshot_id": "rsk_baseline",
      "rate_card_id": "billing_rate_card_example",
      "tier": "standard",
      "blocked_reason": null
    }
  ],
  "page": {
    "next_cursor": null,
    "has_more": false,
    "limit": 100
  },
  "meta": {
    "request_id": "req_example",
    "schema_version": "1.4.2",
    "generated_at": "2026-10-23T14:00:00Z",
    "data_status": "complete"
  }
}

Required scope: monitoring:read

Signal charges the full agreed monthly rate once per borrower/business/workspace at 00:00 UTC on the first day of the month, before monitoring proceeds. First activation during a month charges the full monthly rate immediately, without proration; the next charge is at the next month boundary. Repeated monitor creation, pauses, resumes, checks and reassessments do not add charges in an already paid period. Insufficient credits block monitoring without a debit or debt; funding resumes only the current period after its single successful charge, without charging missed inactive months. User-paused monitoring remains paused until the user resumes it. Account cancellation stops processing and all further deductions immediately. Read one shared record per subject/month, including its charge and workload references. Periods are immutable in identity; current status and charged_at reflect activation. API reads never create a charge.

Product scope · Processing lifecycle · Errors

Authorizations

Authorization · string · header · required

Server-to-server API key bound to exactly one workspace, institution tenant and environment. No caller-supplied workspace override is accepted. Do not use in public browser code.

Query Parameters

subject_id · string

Authorized borrower/business.

period_start · string<date-time>

Inclusive UTC period-start boundary.

period_end · string<date-time>

Exclusive UTC period-start boundary.

limit · integer

Default 100; maximum 200.

Required range: 1 <= x <= 200

cursor · string

Opaque continuation bound to the original filters and snapshot.

Response

200

application/json

Authorized response.

data · object[] · required

Show child attributes

page · object · required

Show child attributes

meta · object · required

Show child attributes