---
title: "List developer logs"
method: GET
path: "/v1/developer-logs"
tags: ["History", "Founder login"]
---

# List developer logs

`GET /v1/developer-logs`

## Request

- Base URL: `https://hyperscale0.ai`
- URL: `https://hyperscale0.ai/v1/developer-logs`
- Auth: HTTP bearer

Lists the company's API operations with their status, latency, receipt, and audit events. Logs cover the whole company, not one Product. Filter by credential with principalId or by an exact requestId.

## 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'
- `resourceId` string
- `createdFrom` string, date-time
- `createdTo` string, date-time
- `limit` integer: Maximum items to return (1-100). Defaults to 50 when omitted.
- `cursor` string
- `principalId` string: Hyperscale principal ID
- `requestId` string: Exact request ID returned by the API

## Headers

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

## Response `200`

Success

- DeveloperLogListOutput
  - `items` object[], required
    - `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
    - `receiptId` string: Hyperscale receipt ID
    - `requestId` string
    - `sourceSurface` string
    - `evidence` object[], required
      - `kind` 'ledger' | 'local' | 'external', required
      - `reference` string, required
      - `externalConfirmationId` string
      - `provider` string
      - `providerReference` string
      - `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'
      - `resourceId` string
      - `operationId` string: Hyperscale operation ID
      - `operation` object
        - `id` string, required: Hyperscale operation ID
        - `name` string
        - `status` string
      - `status` string
      - `occurredAt` string, date-time
      - `proof` object
    - `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
    - `timeline` object[], required
      - `kind` string, required
      - `reference` string
      - `externalConfirmationId` string
      - `provider` string
      - `providerReference` string
      - `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', nullable
      - `resourceId` string, nullable
      - `operationId` string: Hyperscale operation ID
      - `operation` object
        - `id` string, required: Hyperscale operation ID
        - `name` string
        - `status` string
      - `status` string
      - `occurredAt` string, date-time
      - `proof` object
      - `usageRecordId` string: Hyperscale usage record ID
      - `meter` 'account.active_month' | 'account.created.count' | 'transfer.internal.count' | 'transfer.internal.volume_sar' | 'instrument.event.count' | 'operation.executed.count' | 'billing.plan.recurring_month'
      - `quantity` string: Non-negative usage quantity with up to six decimal places (integer part at most 18 digits)
      - `sourceEventId` string
      - `sourceOperationId` string: Hyperscale operation ID
      - `productId` string: Hyperscale product ID
      - `operationName` string
      - `receiptId` string: Hyperscale receipt ID
      - `type` string
      - `finalizedAt` string, date-time, nullable
      - `auditEventId` string
      - `event` string
      - `level` string
      - `body` object
    - `usage` object[], required
      - `usageRecordId` string, required: Hyperscale usage record ID
      - `meter` 'account.active_month' | 'account.created.count' | 'transfer.internal.count' | 'transfer.internal.volume_sar' | 'instrument.event.count' | 'operation.executed.count' | 'billing.plan.recurring_month', required
      - `quantity` string, required: Non-negative usage quantity with up to six decimal places (integer part at most 18 digits)
      - `sourceEventId` string
      - `sourceOperationId` string: Hyperscale operation ID
      - `productId` string: Hyperscale product ID
      - `occurredAt` string, date-time, required
    - `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
    - `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
    - `recordedAt` string, date-time, required: Wall time the request arrived. Logs page in this order; occurredAt is the Product clock, which a sandbox Product can run ahead.
    - `operationId` string, required: Hyperscale operation ID
    - `operation` string, required
    - `status` 'accepted' | 'pending' | 'succeeded' | 'failed', required
    - `resource` object
      - `kind` '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', required
      - `id` string
    - `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'
    - `resourceId` string
    - `receipt` object
      - `id` string, required: Hyperscale receipt ID
      - `status` string, required
      - `type` string, required
      - `finalizedAt` string, date-time, nullable, required
    - `auditEvent` string
    - `audit` object[], required
      - `auditEventId` string, required
      - `event` string, required
      - `level` string
      - `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', nullable
      - `resourceId` string, nullable
      - `body` object
      - `occurredAt` string, date-time, required
    - `principalId` string: Hyperscale principal ID
    - `finalizedAt` string, date-time
    - `latencyMs` integer
  - `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)