Products

List product activity timeline

Return the audit timeline for a product combining its own domain events plus document events whose lines reference it. Paginated with page and per_page query params (default 50).

get/companies/{company}/products/{product}/activities

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/products/{product}/activities
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

productstring uuid required

Public identifier (UUID v7) of the product.

Query parameters

per_pageinteger

Number of entries per page, between 1 and 200 (default 50).

pageinteger

Page number, starting at 1.

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

ProductActivityV1Collection

totalinteger required

Total number of available activities.

current_pageinteger required

Current page (1-based).

per_pageinteger required

Number of activities per page.

frominteger nullable required

Index of the first activity on the page, or null if empty.

tointeger nullable required

Index of the last activity on the page, or null if empty.

last_pageinteger required

Number of the last available page.

Example response

{
  "data": [
    {
      "event_type": "product.updated",
      "description": "Se actualizó el precio base del producto.",
      "metadata": {
        "previous_price": "45.00",
        "new_price": "49.90"
      },
      "performed_by": {
        "type": "user",
        "id": "01928f12-1234-7abc-9def-0123456789ab",
        "name": "Ana García"
      },
      "created_at": "2026-05-15T10:34:21Z"
    }
  ],
  "total": 3,
  "current_page": 1,
  "per_page": 50,
  "from": 1,
  "to": 3,
  "last_page": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.