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

# List AI Inbox Manager activity

> Get the paginated unified activity feed (replies, follow-ups and no-show recoveries) for an AI Inbox Manager, newest first.


Requires one of the following scopes: `ai_inbox_manager_analytics:read`, `ai_agents:all`, `all:read`, `all:all`



## OpenAPI

````yaml https://api.instantly.ai/openapi/api_v2.json get /api/v2/ai-agents/inbox-manager/{id}/analytics/activity
openapi: 3.1.0
info:
  title: API Explorer
  description: >-
    The entire API V2 documentation is interactive and can be tested here. To
    the right side of every endpoint you will see a box with an example request.
    You can click on the "Try it" button to send a request to the server right
    from the docs. You will need to provide an API key by clicking the
    `ApiKeyAuth_token` blue text.
  version: 2.0.0
servers:
  - url: https://api.instantly.ai
    description: Instantly API Server
security:
  - ApiKeyAuth: []
tags:
  - name: Analytics
    description: Endpoints related to analytics
    x-group: Analytics
  - name: OAuth
    description: >-
      OAuth authentication endpoints for connecting Google and Microsoft email
      accounts
    x-group: OAuth
  - name: Account
    description: An email account that can be used to send campaigns
    x-group: Account
  - name: Campaign
    description: A campaign that can be sent to a list of recipients
    x-group: Campaign
  - name: Email
    description: >-
      A campaign email, a reply, a manually sent email, or any other email
      that's visible in the Unibox
    x-group: Email
  - name: EmailVerification
    description: A single email verification
    x-group: Email Verification
  - name: LeadList
    description: A list used to store leads
    x-group: Lead List
  - name: InboxPlacementTest
    description: An inbox placement test
    x-group: Inbox Placement Test
  - name: InboxPlacementAnalytics
    description: Analytics data for individual emails in inbox placement tests
    x-group: Inbox Placement Analytics
  - name: InboxPlacementBlacklistAndSpamAssassinReport
    description: Report data for an inbox placement test
    x-group: Inbox Placement Blacklist And SpamAssassin Report
  - name: AIAgent
    description: An AI agent
    x-group: AI Agent
  - name: AIInboxManager
    description: An AI Inbox Manager agent
    x-group: AI Inbox Manager
  - name: AIDeliverabilityAgent
    description: An AI Deliverability Agent
    x-group: AI Deliverability Agent
  - name: AILeadFinderAgent
    description: An AI Lead Finder Agent
    x-group: AI Lead Finder Agent
  - name: APIKey
    description: API Key
    x-group: API Key
  - name: AccountCampaignMapping
    description: Account Campaign Mapping
    x-group: Account Campaign Mapping
  - name: Lead
    description: A lead entity representing an individual lead
    x-group: Lead
  - name: BackgroundJob
    description: A background job that can be used to perform long-running tasks
    x-group: Background Job
  - name: CustomTag
    description: >-
      A custom tag for organizing and categorizing accounts and campaigns. You
      can use them as filters in apis that list accounts and campaigns.
    x-group: Custom Tag
  - name: CustomTagMapping
    description: >-
      This entity represents a tag being assigned to a specific campaign or
      email account. When an email account is assigned a tag, a new custom tag
      mapping entry is created, which connects the tag (`tag_id` field) with the
      email account (`resource_id` field). You can use it to see which tag si
      connected to which resource.
    x-group: Custom Tag Mapping
  - name: BlockListEntry
    description: A blocked email or domain
    x-group: Block List Entry
  - name: LeadLabel
    description: A custom label for categorizing and managing leads
    x-group: Lead Label
  - name: Workspace
    description: A workspace entity representing a workspace
    x-group: Workspace
  - name: SuperSearchEnrichment
    description: >-
      An enrichment can take different forms, such as email enrichment or
      LinkedIn enrichment. Leads may be imported from SuperSearch using the
      dedicated endpoint, or enriched directly within a list or campaign by
      attaching an enrichment to it.
    x-group: SuperSearch Enrichment
  - name: WorkspaceGroupMember
    description: >-
      A member of a workspace group. You can use the endpoints within this
      entity to manage the members of a workspace group.
    x-group: Workspace Group Member
  - name: WorkspaceMember
    description: A member of a workspace with associated user details
    x-group: Workspace Member
  - name: CampaignSubsequence
    description: A subsequence entity representing a follow-up sequence
    x-group: Campaign Subsequence
  - name: AuditLog
    description: Audit log records for tracking system activities
    x-group: Audit Log
  - name: AISalesAgent
    description: >-
      An AI Sales Development Representative that autonomously manages outreach
      campaigns
    x-group: AI Sales Agent
  - name: AISalesAgentActivity
    description: An activity performed by an AI Sales Agent
    x-group: AI Sales Agent
  - name: Webhook
    description: A webhook subscription for receiving event notifications
    x-group: Webhook
  - name: WebhookEvent
    description: A webhook event that was sent or attempted to be sent
    x-group: Webhook Event
  - name: DFYEmailAccountOrder
    description: A Done-For-You email account order
    x-group: DFY Email Account Order
  - name: DomainForwarding
    description: Web forwarding configuration for a domain ordered through Instantly
    x-group: Domain Forwarding
  - name: CustomPromptTemplate
    description: Custom prompt templates for creating custom prompts
    x-group: Custom Prompt Template
  - name: SalesFlow
    description: >-
      Manages how sales users view and interact with campaign and lead lists
      within the sales flow.
    x-group: Sales Flow
  - name: EmailTemplate
    description: A campaign email template
    x-group: Email Template
  - name: WorkspaceBilling
    description: Workspace Billing
    x-group: Workspace Billing
  - name: CRMActions
    description: CRM related actions
    x-group: CRM Actions
paths:
  /api/v2/ai-agents/inbox-manager/{id}/analytics/activity:
    get:
      tags:
        - AIInboxManager
      summary: List AI Inbox Manager activity
      description: >-
        Get the paginated unified activity feed (replies, follow-ups and no-show
        recoveries) for an AI Inbox Manager, newest first.



        Requires one of the following scopes: `ai_inbox_manager_analytics:read`,
        `ai_agents:all`, `all:read`, `all:all`
      operationId: listInboxManagerActivity
      parameters:
        - schema:
            type: string
            example: 01a0206f-effa-7d14-97d3-1981fcc8380d
          example: 01a0206f-effa-7d14-97d3-1981fcc8380d
          in: query
          name: starting_after
          required: false
          description: Pagination cursor (ID of the last item from the previous page)
        - schema:
            type: number
            default: 25
            minimum: 1
            maximum: 100
            example: 25
          example: 25
          in: query
          name: limit
          required: false
          description: Number of items to return
        - schema:
            type: boolean
            example: true
          example: true
          in: query
          name: action_pending
          required: false
          description: >-
            Filter by action pending status: true for to-do items, false for
            done items. Cannot be combined with `activity_type=recovery` —
            recoveries have no pending action.
        - schema:
            type: string
            enum:
              - reply
              - followup
              - recovery
            example: reply
          example: reply
          in: query
          name: activity_type
          required: false
          description: Filter by activity type
        - schema:
            type: number
            enum:
              - 1
              - 2
              - 3
            example: 1
          example: 1
          in: query
          name: job_type
          required: false
          description: >-
            Filter by work type: 1 = inbox reply, 2 = inbox follow-up, 3 =
            no-show follow-up. Cannot be combined with `activity_type`.
        - schema:
            type: string
            format: uuid
            example: 0195b1a5-3b1d-7b6e-9c1a-2f7a4b0c1d2e
          example: 0195b1a5-3b1d-7b6e-9c1a-2f7a4b0c1d2e
          in: path
          name: id
          required: true
          description: AI Inbox Manager ID
      responses:
        '200':
          description: The unified activity feed for the agent
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  items:
                    type: array
                    description: The list of activities
                    items:
                      type: object
                      description: >-
                        A single entry in the unified activity feed: a reply, a
                        follow-up, or a no-show recovery
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Activity ID
                          examples:
                            - 01a0206f-ab69-7c66-8b99-f41aa0d69b1b
                          example: 01a0206f-ab69-7c66-8b99-f41aa0d69b1b
                        timestamp_created:
                          type: string
                          format: date-time
                          description: When the activity happened
                          examples:
                            - '2026-08-20T18:29:44.425Z'
                          example: '2026-08-20T18:29:44.425Z'
                        activity_type:
                          type: string
                          enum:
                            - reply
                            - followup
                            - recovery
                          description: Kind of activity
                          examples:
                            - reply
                          example: reply
                        job_type:
                          type:
                            - 'null'
                            - number
                          enum:
                            - 1
                            - 2
                            - 3
                            - null
                          description: >-
                            Work type: 1 = inbox reply, 2 = inbox follow-up, 3 =
                            no-show follow-up. Null for recoveries.
                          examples:
                            - 1
                          example: 1
                        lead_email:
                          type: string
                          description: Lead email address the activity relates to
                          examples:
                            - john@example.com
                          example: john@example.com
                        thread_id:
                          type:
                            - 'null'
                            - string
                          description: Conversation thread identifier
                          examples:
                            - 3c-zuFiJhv7cqJE5IoKkg6Pzh9
                          example: 3c-zuFiJhv7cqJE5IoKkg6Pzh9
                        requires_hitl:
                          type:
                            - 'null'
                            - boolean
                          description: >-
                            Whether the activity requires human-in-the-loop
                            review
                          examples:
                            - false
                          example: false
                        action_pending:
                          type:
                            - 'null'
                            - boolean
                          description: >-
                            Whether the activity still requires action from the
                            user
                          examples:
                            - true
                          example: true
                        sending_status:
                          type:
                            - 'null'
                            - number
                          description: >-
                            Email sending status: -1 = failed, 1 = sent, 2 =
                            scheduled
                          examples:
                            - 1
                          example: 1
                        error_code:
                          type:
                            - 'null'
                            - string
                          enum:
                            - NO_SENDING_ACCOUNT
                            - ACCOUNT_INACTIVE
                            - ACCOUNT_FETCH_FAILED
                            - SEND_FAILED
                            - HITL_NOT_SUPPORTED
                            - RATE_LIMITED
                            - AGENT_NOT_FOUND
                            - LEAD_BLOCKED
                            - FREE_TRIAL_LIMIT_REACHED
                            - OUT_OF_CREDITS
                            - MONTHLY_BUDGET_EXCEEDED
                            - null
                          description: Error code for the email sending process
                          examples:
                            - SEND_FAILED
                          example: SEND_FAILED
                        is_followup:
                          type:
                            - 'null'
                            - boolean
                          description: Whether the entry is an automatic follow-up
                          examples:
                            - false
                          example: false
                        followup_number:
                          type:
                            - 'null'
                            - number
                          description: Position of this follow-up in its sequence
                          examples:
                            - 1
                          example: 1
                        estimated_time_saved_seconds:
                          type:
                            - 'null'
                            - number
                          description: Estimated time saved by the agent, in seconds
                          examples:
                            - 30
                          example: 30
                        information_requested:
                          type:
                            - 'null'
                            - string
                          description: Text the agent used to request more information
                          examples:
                            - Please confirm your availability.
                          example: Please confirm your availability.
                        recovery_method:
                          type:
                            - 'null'
                            - string
                          enum:
                            - calendly_meeting
                            - lead_reply
                            - manual
                            - null
                          description: How the lead was recovered. Only set for recoveries.
                          examples:
                            - calendly_meeting
                          example: calendly_meeting
                        revenue_recovered:
                          type:
                            - 'null'
                            - number
                          description: Revenue recovered by this recovery, if known
                          examples:
                            - 500
                          example: 500
                  next_starting_after:
                    type: string
                    description: >-
                      Pass as `starting_after` to fetch the next page. Absent on
                      the last page.
                    examples:
                      - 01a0206f-effa-7d14-97d3-1982383692c6
                    example: 01a0206f-effa-7d14-97d3-1982383692c6
                  has_more:
                    type: boolean
                    description: Whether more activities exist after this page
                    examples:
                      - true
                    example: true
        '400':
          description: >-
            The request is invalid (e.g. missing required fields, invalid field
            values, or an invalid state for the operation)
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    enum:
                      - 400
                    examples:
                      - 400
                    example: 400
                  error:
                    type: string
                    enum:
                      - Bad Request
                    examples:
                      - Bad Request
                    example: Bad Request
                  message:
                    type: string
                    examples:
                      - body must have required property 'name'
                    example: body must have required property 'name'
                required:
                  - statusCode
                  - error
                  - message
        '401':
          description: >-
            This request is unauthorized (either the Authorization header is
            missing or invalid, or the API key has been revoked)
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    enum:
                      - 401
                    examples:
                      - 401
                    example: 401
                  error:
                    type: string
                    enum:
                      - Unauthorized
                    examples:
                      - Unauthorized
                    example: Unauthorized
                  message:
                    type: string
                    examples:
                      - Missing Authorization header
                    example: Missing Authorization header
                required:
                  - statusCode
                  - error
                  - message
        '402':
          description: >-
            This request cannot be fulfilled because the workspace does not have
            an active paid plan
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    enum:
                      - 402
                    examples:
                      - 402
                    example: 402
                  error:
                    type: string
                    enum:
                      - Payment Required
                    examples:
                      - Payment Required
                    example: Payment Required
                  message:
                    type: string
                    examples:
                      - Workspace does not have an active paid plan
                    example: Workspace does not have an active paid plan
                required:
                  - statusCode
                  - error
                  - message
        '404':
          description: The requested resource was not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    enum:
                      - 404
                    examples:
                      - 404
                    example: 404
                  error:
                    type: string
                    enum:
                      - Not Found
                    examples:
                      - Not Found
                    example: Not Found
                  message:
                    type: string
                    examples:
                      - Resource not found
                    example: Resource not found
                required:
                  - statusCode
                  - error
                  - message
        '429':
          description: >-
            You have exceeded the rate limit. Please check the rate limit docs
            for more information.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    enum:
                      - 429
                    examples:
                      - 429
                    example: 429
                  error:
                    type: string
                    enum:
                      - Too Many Requests
                    examples:
                      - Too Many Requests
                    example: Too Many Requests
                  message:
                    type: string
                    examples:
                      - Rate limit exceeded
                    example: Rate limit exceeded
                required:
                  - statusCode
                  - error
                  - message
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer

````