---
title: "List company activity"
method: GET
path: "/v1/activity"
tags: ["History"]
---

# List company activity

`GET /v1/activity`

## Request

- Base URL: `https://hyperscale0.ai`
- URL: `https://hyperscale0.ai/v1/activity`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Lists the company's activity, newest first, 20 to a page by default. An MCP call defaults to two, so an agent reads the page whole; pass limit for more. Each row names what happened, who did it, the record and its money moves with their customers. Filter by resource kind, by a record, account or customer id in resourceId, or by type: object, money_move, or company_access. A row carries its first five money moves and moveCount; activity.retrieve returns the row with every move, its evidence, usage and timeline.

## Query parameters

- `productId` string: Hyperscale product ID
- `operation` string
- `status` 'accepted' | 'pending' | 'succeeded' | 'failed'
- `resourceKind` 'account' | 'activity' | 'api_key' | 'audit' | 'product_capability' | 'consent' | 'customer' | 'entity' | 'instrument_instance' | 'business_object' | 'operation' | 'product' | 'customer_access' | 'customer_session' | 'external_confirmation' | 'provider_cost_event' | 'provider_webhook_event' | 'webhook_endpoint' | 'webhook_delivery' | 'receipt' | 'tenant' | 'tenant_catalog_revision' | 'reporting_artifact' | 'wedged_money_repair' | 'user_session' | 'internal_transfer' | 'usage' | 'platform_alert' | 'team' | 'team_membership' | 'user'
- `resourceId` string
- `createdFrom` string, date-time
- `createdTo` string, date-time
- `limit` integer: Maximum items to return (1-100). Defaults to 20 when omitted, or 2 over MCP.
- `cursor` string
- `type` 'object' | 'money_move' | 'company_access'

## Headers

- `X-Hyperscale-Environment` 'sandbox' | 'live'

## Response `200`

Success

- ActivityListOutput
  - `items` union[], required
    - union
      - object
        - `activityId` string, required: Row key for the unified timeline: the operation id for operation rows, the audit event id for audit rows
        - `occurredAt` string, date-time, required
        - `errorEnvelope` object
          - `code` string, required
          - `message` string, required
          - `status` integer, required
          - `details` unknown
          - `fix` string, nullable, required: The next step: the refusal's own when it names one, else its error code's catalog action
        - `title` string, required
        - `actor` object, required
          - `id` string, nullable, required
          - `name` string, required
        - `product` object, nullable, required
          - `id` string, required: Hyperscale product ID
          - `name` string, required
        - `subject` union, required
          - object
            - `kind` 'object', required
            - `productId` string, required: Hyperscale product ID
            - `objectKind` string, required
            - `objectId` string, required
            - `title` string, required
          - object
            - `kind` 'money_move', required
            - `resourceKind` 'account' | 'internal_transfer', required
            - `resourceId` string, required
          - object
            - `kind` 'company_access', required
            - `resourceKind` string, required
            - `resourceId` string, nullable, required
        - `customer` object, nullable, required: The one customer every move names, or null
          - `id` string, required
          - `name` string, required
        - `amount` object, nullable, required: The money the entry moved in one currency, or null
          - `value` string, required
          - `currency` string, required
        - `moves` object[], required: The money moves the entry made, oldest first. A list row carries the first five; retrieve carries all of them
          - `transferId` string, required: internal_transfer.retrieve names both accounts
          - `amount` object, required
            - `value` string, required
            - `currency` string, required
          - `from` string, required: The paying account, such as `Faisal Alqahtani's customer balance`
          - `to` string, required: The receiving account, such as `deposit held for Trek FX 3`
          - `customer` object, nullable, required
            - `id` string, required
            - `name` string, required
          - `object` object, nullable, required
            - `kind` string, required
            - `id` string, required
            - `title` string, required
          - `action` string, nullable, required: The program's action in its own words, such as `pay dues 2 of 12`, or `pay dues #2` for a plan that runs until stopped
        - `moveCount` integer, required: How many money moves the entry made in all
        - `operationId` string, required: Hyperscale operation ID
        - `operation` string, required
        - `status` 'accepted' | 'pending' | 'succeeded' | 'failed', required
      - object
        - `activityId` string, required: Row key for the unified timeline: the operation id for operation rows, the audit event id for audit rows
        - `occurredAt` string, date-time, required
        - `errorEnvelope` object
          - `code` string, required
          - `message` string, required
          - `status` integer, required
          - `details` unknown
          - `fix` string, nullable, required: The next step: the refusal's own when it names one, else its error code's catalog action
        - `title` string, required
        - `actor` object, required
          - `id` string, nullable, required
          - `name` string, required
        - `product` object, nullable, required
          - `id` string, required: Hyperscale product ID
          - `name` string, required
        - `subject` union, required
          - object
            - `kind` 'object', required
            - `productId` string, required: Hyperscale product ID
            - `objectKind` string, required
            - `objectId` string, required
            - `title` string, required
          - object
            - `kind` 'money_move', required
            - `resourceKind` 'account' | 'internal_transfer', required
            - `resourceId` string, required
          - object
            - `kind` 'company_access', required
            - `resourceKind` string, required
            - `resourceId` string, nullable, required
        - `customer` object, nullable, required: The one customer every move names, or null
          - `id` string, required
          - `name` string, required
        - `amount` object, nullable, required: The money the entry moved in one currency, or null
          - `value` string, required
          - `currency` string, required
        - `moves` object[], required: The money moves the entry made, oldest first. A list row carries the first five; retrieve carries all of them
          - `transferId` string, required: internal_transfer.retrieve names both accounts
          - `amount` object, required
            - `value` string, required
            - `currency` string, required
          - `from` string, required: The paying account, such as `Faisal Alqahtani's customer balance`
          - `to` string, required: The receiving account, such as `deposit held for Trek FX 3`
          - `customer` object, nullable, required
            - `id` string, required
            - `name` string, required
          - `object` object, nullable, required
            - `kind` string, required
            - `id` string, required
            - `title` string, required
          - `action` string, nullable, required: The program's action in its own words, such as `pay dues 2 of 12`, or `pay dues #2` for a plan that runs until stopped
        - `moveCount` integer, required: How many money moves the entry made in all
        - `auditEvent` string, required
  - `nextCursor` string

## Other responses

- `default`: ErrorResponse. See x-error-codes and x-errors for codes, HTTP statuses and retry guidance.

---

[API](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api.md) · [All operations](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperscale0/apis/hyperscale-product-api/revisions/e9e8faa044d5?raw)
