How do I pull the full change history for a product via the External API?

Last updated: October 5, 2026

Product activity log via the External API

The Luminous External V1 activity-log endpoint now supports product as a subject type, giving you a paginated, time-ordered log of every create, update, and delete event for any SKU.

Endpoint

GET /external/api/v1/activity-logs

Authentication: External API key — Authorization: Bearer <token>

Required parameters

Parameter

Type

Description

subjectType

string

Must be product

subjectId

integer

The Luminous product ID

Optional parameters

Parameter

Description

userType

user (human actions only) or system (automated only). Omit for both.

dateSort

asc or desc — sort direction on created_at.

limit

Pagination (default to 25 ,max 100).

Example request

GET /external/api/v1/activity-logs?subjectType=product&subjectId=4201&dateSort=desc&limit=25

Understanding the response

Each entry in data represents one discrete change:

{
  "data": [
    {
      "id": 9910,
      "description": "created",
      "createdAt": "2026-01-15T09:30:00.000000Z",
      "properties": {
        "via": "import",
        "attributes": { "name": "Blue Widget", "sku": "WIDGET-BLU" }
      },
      "causer": null
    },
    {
      "id": 10452,
      "description": "updated",
      "createdAt": "2026-09-28T14:02:00.000000Z",
      "properties": {
        "via": "user",
        "attributes": { "retail_price": 29.99 },
        "old": { "retail_price": 24.99 }
      },
      "causer": { "id": 7, "name": "Jane Smith", "email": "jane@example.com" }
    }
  ]
}

Key fields:

  • description — created, updated, or deleted.

  • properties.via — the source channel for this event (user, api, import, auto_create_sku, job, system).

  • properties.attributes — field values after the change.

  • properties.old — field values before the change (present on updated events).

  • causer — the user who made the change; null for automated/system events.

Ask an AI question about a product's history

For a plain-language summary of what happened to a product, use the AI endpoint:

POST /external/api/v1/activity-logs/ask-ai
{
  "subjectType": "product",
  "subjectId": 4201,
  "question": "Who changed the retail price, and when?"
}

The AI reviews up to the 100 most recent activity entries for the product and returns a plain-text answer. Questions can be up to 1,000 characters.

Tips

  • Use dateSort=asc to read the history in chronological order from creation.

  • Use userType=system to isolate automated changes (imports, jobs, API writes).

  • Paginate with links.next for SKUs with long histories — the max page size is 100 entries.

  • A deleted event logs a soft-delete (the product was discontinued or removed), not a hard database delete.