Activity Log

The activity log endpoints give you a tamper-evident audit trail for all subscription lifecycle events. You can query the global log for DataTable views, fetch the full state-diff payload for a single event, or retrieve the ordered timeline scoped to one subscription. All routes are read-only, require an authenticated Medusa Admin user, and default to created_at desc ordering.

All routes require an authenticated Medusa Admin user. Unauthenticated requests return 401.

Actor type values

Value	Meaning
`user`	Medusa Admin user
`customer`	Storefront customer who triggered the action
`system`	Internal system action
`scheduler`	Scheduled job

Event type groups

Events are namespaced by domain: subscription.*, renewal.*, dunning.*, cancellation.*. The subscription.* group includes the initial subscription.created event written when a subscription is first created through storefront checkout.

GET /admin/subscription-logs

Returns the paginated global activity log for Admin DataTable views.

Query parameters

number

Number of results per page.

number

Zero-based result offset for pagination.

string

Free-text search.

string

Field to sort by. Database-backed: created_at, event_type, actor_type. In-memory: subscription_reference, customer_name, reason.

string

Sort direction. One of asc or desc. Defaults to desc.

string

Filter to events for a specific subscription.

string

Filter to events for a specific customer.

string | string[]

Filter by event type. Accepts a single value or an array.

string | string[]

Filter by actor type. Accepts a single value or an array.

string

ISO datetime lower bound for created_at.

string

ISO datetime upper bound for created_at.

Response

object[]

required

Array of activity log list items.

Show log item properties

string

Log record ID.

string

ID of the linked subscription.

string

Namespaced event type (e.g. subscription.paused or subscription.created).

string

Type of actor that triggered the event.

string | null

Raw actor ID, or null for system/scheduler actors.

object

Enriched actor summary with type, id, email, name, and display.

object

Subscription summary with reference, customer name, product info, and variant title.

string | null

Reason recorded with the event, or null.

string

Comma-separated list of changed field names.

string

Event timestamp.

number

required

Total matching records.

number

required

Page size used.

number

required

Result offset used.

Response example

{
  "subscription_logs": [
    {
      "id": "slog_123",
      "subscription_id": "sub_123",
      "event_type": "subscription.created",
      "actor_type": "customer",
      "actor_id": "cus_123",
      "actor": {
        "type": "customer",
        "id": "cus_123",
        "email": null,
        "name": "Jane Doe",
        "display": "Jane Doe"
      },
      "subscription": {
        "subscription_id": "sub_123",
        "reference": "SUB-001",
        "customer_id": "cus_123",
        "customer_name": "Jane Doe",
        "product_title": "Coffee Subscription",
        "variant_title": "1 kg"
      },
      "reason": null,
      "change_summary": "subscription_created",
      "created_at": "2026-04-15T10:00:00.000Z"
    }
  ],
  "count": 1,
  "limit": 20,
  "offset": 0
}

Errors

Code	Error	Meaning
`400`	`invalid_data`	Invalid query parameter shape or unsupported sort field

GET /admin/subscription-logs/:id

Returns the full detail payload for a single activity log event, including the previous state, new state, and a field-level diff.

Path parameters

string

required

Activity log record ID.

Response

Returns a subscription_log object with all list fields plus:

object

required

Show additional detail fields

object | null

State snapshot before the event.

object | null

State snapshot after the event.

object[]

Field-level diff. Each entry has field, before, and after.

object | null

Event-specific metadata (e.g. linked renewal_cycle_id or order_id).

Response example

{
  "subscription_log": {
    "id": "slog_123",
    "subscription_id": "sub_123",
    "event_type": "renewal.succeeded",
    "actor_type": "scheduler",
    "actor_id": null,
    "actor": {
      "type": "scheduler",
      "id": null,
      "email": null,
      "name": null,
      "display": null
    },
    "subscription": {
      "subscription_id": "sub_123",
      "reference": "SUB-001",
      "customer_id": "cus_123",
      "customer_name": "Jane Doe",
      "product_title": "Coffee Subscription",
      "variant_title": "1 kg"
    },
    "reason": null,
    "change_summary": "status, processed_at",
    "created_at": "2026-04-15T10:03:00.000Z",
    "previous_state": {
      "status": "scheduled"
    },
    "new_state": {
      "status": "succeeded"
    },
    "changed_fields": [
      {
        "field": "status",
        "before": "scheduled",
        "after": "succeeded"
      }
    ],
    "metadata": {
      "renewal_cycle_id": "re_123",
      "order_id": "order_123"
    }
  }
}

Errors

Code	Error	Meaning
`404`	`not_found`	Activity log record does not exist

GET /admin/subscriptions/:id/logs

Returns the paginated activity log timeline scoped to a single subscription. Accepts the same query parameters as the global list and applies subscription_id = :id automatically.

Path parameters

string

required

Subscription ID.

Query parameters

Same as GET /admin/subscription-logs. Default sort is created_at desc.

Response

Same shape as GET /admin/subscription-logs.

Response example

{
  "subscription_logs": [
    {
      "id": "slog_123",
      "subscription_id": "sub_123",
      "event_type": "subscription.paused",
      "actor_type": "user",
      "actor_id": "user_123",
      "actor": {
        "type": "user",
        "id": "user_123",
        "email": "admin@example.com",
        "name": "Admin User",
        "display": "admin@example.com"
      },
      "subscription": {
        "subscription_id": "sub_123",
        "reference": "SUB-001",
        "customer_id": "cus_123",
        "customer_name": "Jane Doe",
        "product_title": "Coffee Subscription",
        "variant_title": "1 kg"
      },
      "reason": "customer requested pause",
      "change_summary": "status, paused_at",
      "created_at": "2026-04-15T10:00:00.000Z"
    }
  ],
  "count": 1,
  "limit": 20,
  "offset": 0
}

Admin API

Store API

Actor type values

Event type groups

GET /admin/subscription-logs

Query parameters

Response

Errors

GET /admin/subscription-logs/:id

Path parameters

Response

Errors

GET /admin/subscriptions/:id/logs

Path parameters

Query parameters

Response

​Actor type values

​Event type groups

​GET /admin/subscription-logs

​Query parameters

​Response

​Errors

​GET /admin/subscription-logs/:id

​Path parameters

​Response

​Errors

​GET /admin/subscriptions/:id/logs

​Path parameters

​Query parameters

​Response

Actor type values

Event type groups

GET /admin/subscription-logs

Query parameters

Response

Errors

GET /admin/subscription-logs/:id

Path parameters

Response

Errors

GET /admin/subscriptions/:id/logs

Path parameters

Query parameters

Response