> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent event stream

> The agents' sessions and turn summaries, oldest first.

With activity access, also includes tool events; when an event's `payload.storage_ref` is present, read its full
payload from `GET …/events/{event_id}/payload`. For a live feed, use `GET …/events/stream`.
Omit `before` to page forward from the start. Use `before=latest` to page backward; each window is oldest first.



## OpenAPI

````yaml /openapi.json get /v1/atlas/investigations/{investigation_id}/events
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for people and companies: research agents that investigate,
    resolve identities, map relationships and surface risk signals.
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Feedback
    description: >-
      Tell us a result was wrong, missing or outdated, and report problems with
      the API, the docs or a tool.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Start, continue and read Atlas investigations: attribution graph,
      workspace files, reports and exports.
paths:
  /v1/atlas/investigations/{investigation_id}/events:
    get:
      tags:
        - Atlas
      summary: Agent event stream
      description: >-
        The agents' sessions and turn summaries, oldest first.


        With activity access, also includes tool events; when an event's
        `payload.storage_ref` is present, read its full

        payload from `GET …/events/{event_id}/payload`. For a live feed, use
        `GET …/events/stream`.

        Omit `before` to page forward from the start. Use `before=latest` to
        page backward; each window is oldest first.
      operationId: get_events_v1_atlas_investigations__investigation_id__events_get
      parameters:
        - name: investigation_id
          in: path
          required: true
          schema:
            type: string
            description: Investigation id, as returned by list or by an xhigh enrichment.
            title: Investigation Id
          description: Investigation id, as returned by list or by an xhigh enrichment.
        - name: after
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 2048
              - type: 'null'
            description: >-
              Cursor from a previous forward page's `next_cursor`. Mutually
              exclusive with `before`.
            title: After
          description: >-
            Cursor from a previous forward page's `next_cursor`. Mutually
            exclusive with `before`.
        - name: before
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 2048
              - type: 'null'
            description: >-
              `latest` for the newest window, then the opaque `next_cursor` for
              the next older window. Mutually exclusive with `after`.
            title: Before
          description: >-
            `latest` for the newest window, then the opaque `next_cursor` for
            the next older window. Mutually exclusive with `after`.
        - name: node_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 200
              - type: 'null'
            description: >-
              Only this recursive node's passes. Requires activity access; keep
              unchanged when following a cursor.
            title: Node Id
          description: >-
            Only this recursive node's passes. Requires activity access; keep
            unchanged when following a cursor.
      responses:
        '200':
          description: Investigation sessions and turn summaries.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentEventStreamPage'
        '400':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/PublicJobError'
                  - additionalProperties:
                      $ref: '#/components/schemas/JsonValue'
                    type: object
                title: >-
                  Response 400 Get Events V1 Atlas Investigations  Investigation
                  Id  Events Get
          description: Bad Request
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Invalid API key
                code: unauthenticated
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '403':
          description: Organization access is locked.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: >-
                  This organization no longer has access to Sixtyfour. Contact
                  your representative at Sixtyfour.
                code: forbidden
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '404':
          description: No such investigation, or not one you may see.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Not found
                code: not_found
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '422':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/PublicJobError'
                  - additionalProperties:
                      $ref: '#/components/schemas/JsonValue'
                    type: object
                title: >-
                  Response 422 Get Events V1 Atlas Investigations  Investigation
                  Id  Events Get
          description: Unprocessable Entity
        '429':
          description: >-
            More than 120 requests per minute per organization. Retry after the
            delay in Retry-After.
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '1'
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: >-
                  Rate limit exceeded: 120 requests per minute. Retry after 1
                  second.
                code: rate_limited
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
          x-rate-limit:
            requests: 120
            period_seconds: 60
            scope: organization
        '500':
          description: Unexpected server error. Retry with backoff.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Internal server error
                code: internal_error
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '503':
          description: >-
            Temporarily unavailable. Nothing was charged; retry after the
            `Retry-After` header.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Could not verify the API key right now. Retry shortly.
                code: unavailable
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
components:
  schemas:
    AgentEventStreamPage:
      properties:
        events:
          items:
            $ref: '#/components/schemas/AgentEvent'
          type: array
          title: Events
          description: Oldest first.
        sessions:
          items:
            $ref: '#/components/schemas/AgentSession'
          type: array
          title: Sessions
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: >-
            Pass as `after` for the next forward page, or as `before` for the
            next older page when paging backward. Keep the same node_id.
      type: object
      required:
        - events
        - sessions
      title: AgentEventStreamPage
    PublicJobError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
      title: PublicJobError
    JsonValue: {}
    AgentEvent:
      properties:
        id:
          type: string
          title: Id
        agent_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Id
        session_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Session Id
          description: The agent session in `sessions` the event belongs to.
        parent_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Parent Id
        seq:
          anyOf:
            - type: integer
            - type: 'null'
          title: Seq
          description: The event's position in the stream.
        turn:
          anyOf:
            - type: integer
            - type: 'null'
          title: Turn
        kind:
          type: string
          title: Kind
          description: '`turn_summary` for a turn summary; tool events carry other kinds.'
        tool:
          anyOf:
            - type: string
            - type: 'null'
          title: Tool
          description: The tool a tool event called.
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
        detail:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Detail
        duration_ms:
          anyOf:
            - type: integer
            - type: 'null'
          title: Duration Ms
        ok:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Ok
          description: Whether the tool call succeeded.
        created_at:
          type: string
          title: Created At
        payload:
          anyOf:
            - $ref: '#/components/schemas/AgentEventPayload'
            - type: 'null'
          description: >-
            With activity access: arguments, result and reasoning, or a
            storage_ref for a large payload.
      additionalProperties: true
      type: object
      required:
        - id
        - kind
        - created_at
      title: AgentEvent
      description: >-
        One event of the agent stream: a turn summary, or with activity access a
        tool call.
    AgentSession:
      properties:
        id:
          type: string
          title: Id
        parent_session_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Parent Session Id
        agent_type:
          type: string
          title: Agent Type
        agent_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Name
        display_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Name
        task:
          anyOf:
            - type: string
            - type: 'null'
          title: Task
        status:
          type: string
          title: Status
        started_at:
          type: string
          title: Started At
        ended_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Ended At
        turn_count:
          type: integer
          title: Turn Count
        cost_cents:
          anyOf:
            - type: integer
            - type: 'null'
          title: Cost Cents
          description: >-
            Deprecated. Use `cost_credits`. The same amount in tenths of a
            credit.
          deprecated: true
        cost_credits:
          anyOf:
            - type: number
            - type: 'null'
          title: Cost Credits
          description: >-
            Session spend in credits; `null` until the charge is recorded,
            shortly after the run ends.
        spend_access:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Spend Access
          description: >-
            Set when the cost is withheld from the caller, who may not see what
            the investigation's creator spent: why, as `state`, `reason` and
            `message`. `cost_cents` and `cost_credits` are then null.
      type: object
      required:
        - id
        - agent_type
        - status
        - started_at
        - turn_count
        - cost_cents
        - cost_credits
      title: AgentSession
    V1ErrorCode:
      type: string
      enum:
        - invalid_cursor
        - request_in_progress
        - limit_exceeded
        - entity_type_mismatch
        - unsupported_file
        - invalid_upload
        - file_too_large
        - items_not_available
        - list_not_ready
        - job_not_finished
        - not_found
        - validation_error
        - rate_limited
        - internal_error
        - unavailable
        - unauthenticated
        - forbidden
        - insufficient_credits
        - idempotency_key_reused
        - export_source_changed
        - job_execution_changed
        - job_failed
        - item_failed
        - aborted
        - workflow_changed
        - workflow_locked
        - workflow_not_runnable
        - timed_out
      title: V1ErrorCode
    AgentEventPayload:
      properties:
        event_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Event Id
          description: >-
            The event's id. Only the payload route returns it; in the event
            list, use the event's `id`.
        args:
          $ref: '#/components/schemas/JsonValue'
          description: The tool's input arguments.
        result:
          anyOf:
            - type: string
            - type: 'null'
          title: Result
          description: The tool's output.
        thinking:
          anyOf:
            - type: string
            - type: 'null'
          title: Thinking
          description: The agent's reasoning for this event.
        storage_ref:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/JsonValue'
              type: object
            - type: 'null'
          title: Storage Ref
          description: >-
            When present, fetch the full payload from GET
            /v1/atlas/investigations/{investigation_id}/events/{event_id}/payload
            using the event's id. Treat this reference as opaque.
      type: object
      title: AgentEventPayload
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.