---
title: "Company Activity Messages"
method: GET
path: "/companies/{company_id}/activity/messages"
tags: ["sessions"]
---

# Company Activity Messages

`GET /companies/{company_id}/activity/messages`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/activity/messages`
- Auth: HTTP bearer

A page of the company's activity, displayed oldest first. The first
page (no ``before``) also returns the active runs and the stream cursor.
An unknown or missing ``tz`` counts the traffic rows in UTC.

## Path parameters

- `company_id` string, uuid, required

## Query parameters

- `before` string, nullable
- `limit` integer
- `tz` string, nullable

## Response `200`

Successful Response

- ActivityPageResponse
  - `events` ActivityEvent[], required
    - `key` string, required
    - `kind` 'message' | 'milestone' | 'business', required
    - `event_at` string, date-time, required
    - `run_id` string, nullable
    - `message` RunMessageResponse
      - `id` string, required
      - `run_id` string, required
      - `message_type` 'log' | 'assistant' | 'tool_use' | 'tool_result' | 'error' | 'system' | 'user' | 'thinking', required
      - `content` string, required
      - `metadata` object, nullable
      - `seq` integer, nullable
      - `created_at` string, date-time, required
    - `milestone` 'started' | 'completed' | 'failed' | 'interrupted', nullable
    - `business` ActivityBusiness: What happened to the business without an agent doing it (spec 2026-11-09 ACTIVITY_FEED, "Business events"). Only the fields its type uses are set; amounts are in the currency's minor unit. Founder-facing values only: no provider name, no provider id.
      - `type` 'payment' | 'refund' | 'payout_requested' | 'payout_paid' | 'subscriber_joined' | 'cancellation_scheduled' | 'renewal_failed' | 'subscription_ended' | 'email_received' | 'site_paused' | 'site_resumed' | 'domain_bought' | 'domain_live' | 'first_dollar' | 'first_visitor' | 'launch_step' | 'launch_post' | 'visits', required
      - `amount_cents` integer, nullable
      - `currency` string, nullable
      - `credited_cents` integer, nullable
      - `sale_kind` string, nullable
      - `products` string[]
      - `customer` string, nullable
      - `email_id` string, nullable
      - `sender` string, nullable
      - `subject` string, nullable
      - `domain` string, nullable
      - `label` string, nullable
      - `url` string, nullable
      - `cancel_at` string, date-time, nullable
      - `day` string, nullable
      - `count` integer, nullable
  - `companions` RunMessageResponse[]
    - `id` string, required
    - `run_id` string, required
    - `message_type` 'log' | 'assistant' | 'tool_use' | 'tool_result' | 'error' | 'system' | 'user' | 'thinking', required
    - `content` string, required
    - `metadata` object, nullable
    - `seq` integer, nullable
    - `created_at` string, date-time, required
  - `sources` object
  - `active` ActivitySource[]
    - `run_id` string, required
    - `session_id` string, nullable
    - `source_kind` 'main' | 'goal' | 'routine' | 'scheduled' | 'chat' | 'founding', required
    - `title` string, nullable
    - `goal_id` string, nullable
    - `status` string, required
    - `trigger` string, required
    - `created_at` string, date-time, required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `interrupt_requested_at` string, date-time, nullable
  - `emails` object
  - `has_more` boolean, required
  - `before` string, nullable
  - `stream_cursor` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-11** `1afb36798219`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/activity/messages/get.md)

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/9ae15755356c?raw)
