> ## Documentation Index > Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt > Use this file to discover all available pages before exploring further. # A research run's progress events > The run's progress log in ascending `seq` order (the durable source of truth for what the agent did). Poll with `sinceSeq` set to the last `seq` you have seen: only newer events come back. A full page sets `nextSinceSeq` to its last seq (pass it as the next `sinceSeq`); otherwise it is null and you are caught up. `status` is the run's current status so a poller can stop when it is completed, failed or cancelled. Event types: run.status_changed, plan.created, tool.started, tool.finished, progress, partial_result, artifact, run.completed, run.failed, run.cancelled; `payload` depends on the type. Rate limit: 30 requests per minute, 1000 per day. Errors: - `404` `RESEARCH_RUN_NOT_FOUND` — No research run with that id belongs to the token owner. - `422` `VALIDATION_FAILED` — `runId` is not a 24-character hex id, `sinceSeq` is not an integer of 0 or more, or `limit` is outside 1-500. - `429` `RATE_LIMITED` — Per-user quota for this endpoint family exceeded (30 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds. Requires one of the following token scopes: research. ## OpenAPI ````yaml /openapi.json get /business/research/runs/{runId}/events openapi: 3.1.0 info: title: Fuse Business API version: 1.0.0 description: >- External API for lists, campaigns, prospect search and contacts. Authenticate with your API token as HTTP Basic. All paths are under /api/v1. servers: - url: https://api.tryfuse.ai/api/v1 description: Production security: - basicAuth: [] tags: - name: Lists - name: Custom columns - name: Smart columns - name: Exports - name: Campaigns - name: Knowledge hubs - name: Analytics - name: Website intent - name: Account - name: Prospect search - name: Campaign steps - name: Scheduled sends - name: Campaign templates - name: Agents - name: Research - name: Company search - name: Saved searches - name: Folders - name: Contacts paths: /business/research/runs/{runId}/events: get: tags: - Research summary: A research run's progress events description: >- The run's progress log in ascending `seq` order (the durable source of truth for what the agent did). Poll with `sinceSeq` set to the last `seq` you have seen: only newer events come back. A full page sets `nextSinceSeq` to its last seq (pass it as the next `sinceSeq`); otherwise it is null and you are caught up. `status` is the run's current status so a poller can stop when it is completed, failed or cancelled. Event types: run.status_changed, plan.created, tool.started, tool.finished, progress, partial_result, artifact, run.completed, run.failed, run.cancelled; `payload` depends on the type. Rate limit: 30 requests per minute, 1000 per day. Errors: - `404` `RESEARCH_RUN_NOT_FOUND` — No research run with that id belongs to the token owner. - `422` `VALIDATION_FAILED` — `runId` is not a 24-character hex id, `sinceSeq` is not an integer of 0 or more, or `limit` is outside 1-500. - `429` `RATE_LIMITED` — Per-user quota for this endpoint family exceeded (30 per minute, 1000 per day); retry after the Retry-After / RateLimit-Reset seconds. Requires one of the following token scopes: research. operationId: listResearchRunEvents parameters: - name: runId in: path required: true description: >- The research run id (24-character hex), as returned in `run.runId` by POST /business/research/runs. schema: type: string description: >- The research run id (24-character hex), as returned in `run.runId` by POST /business/research/runs. - name: sinceSeq in: query required: false description: >- Return only events whose `seq` is strictly greater than this value; pass the last `seq` you received (or `nextSinceSeq`) to poll incrementally, omit it for the first page. schema: type: integer minimum: 0 description: >- Return only events whose `seq` is strictly greater than this value; pass the last `seq` you received (or `nextSinceSeq`) to poll incrementally, omit it for the first page. - name: limit in: query required: false description: >- Maximum number of events per page, 1 to 500 (default 100); when a page comes back full, `nextSinceSeq` carries the last `seq` to continue from. schema: type: integer minimum: 1 maximum: 500 description: >- Maximum number of events per page, 1 to 500 (default 100); when a page comes back full, `nextSinceSeq` carries the last `seq` to continue from. responses: '200': description: Success headers: RateLimit-Limit: schema: type: integer description: Requests permitted in the current window. RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. RateLimit-Reset: schema: type: integer description: Seconds until the current window resets. content: application/json: schema: type: object properties: runId: type: string events: type: array items: type: object properties: seq: type: integer type: type: string enum: - run.status_changed - plan.created - tool.started - tool.finished - progress - partial_result - artifact - run.completed - run.failed - run.cancelled payload: type: object additionalProperties: true ts: type: string format: date-time required: - seq - type - payload - ts nextSinceSeq: type: - integer - 'null' status: type: string enum: - queued - planning - plan_review - running - generating_csv - uploading - completed - failed - cancelled required: - runId - events - nextSinceSeq - status example: runId: 68a205cc9c41d20014b40888 events: - seq: 3 type: run.status_changed payload: from: planning to: running ts: '2026-08-25T10:00:41.000Z' - seq: 4 type: tool.started payload: tool: web_search input: query: European fintech Series A 2026 Head of Sales ts: '2026-08-25T10:01:05.000Z' - seq: 5 type: progress payload: message: Reviewing 18 candidate companies ts: '2026-08-25T10:02:10.000Z' nextSinceSeq: null status: running '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' security: - basicAuth: [] components: schemas: Error: type: object properties: error: type: object properties: code: type: string message: type: string param: type: - string - 'null' doc_url: type: - string - 'null' request_id: type: - string - 'null' required: - code - message required: - error securitySchemes: basicAuth: type: http scheme: basic description: >- Your API token (`af_…`) as the Basic-auth username, with an empty password. ````