> ## 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 state, report, and result list > A research run's full state. Poll it until `status` is completed, failed or cancelled (in-flight statuses: queued, planning, plan_review, running, generating_csv, uploading). `prompt` is the text the run was started with; `spend` shows the credits reserved, settled and the cap `effort` set; `reportMarkdown` is the markdown report (null until the run writes it); `resultListId` is the list holding the people or companies the research surfaced (null when none was created), readable with GET /business/lists/{listId}; `errorCode` explains a failed run and `cancelRequestedAt` is set once a cancel has been accepted. 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. - `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} 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}: get: tags: - Research summary: A research run's state, report, and result list description: >- A research run's full state. Poll it until `status` is completed, failed or cancelled (in-flight statuses: queued, planning, plan_review, running, generating_csv, uploading). `prompt` is the text the run was started with; `spend` shows the credits reserved, settled and the cap `effort` set; `reportMarkdown` is the markdown report (null until the run writes it); `resultListId` is the list holding the people or companies the research surfaced (null when none was created), readable with GET /business/lists/{listId}; `errorCode` explains a failed run and `cancelRequestedAt` is set once a cancel has been accepted. 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. - `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: getResearchRun 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. 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: run: type: object properties: runId: type: - string - 'null' prompt: type: - string - 'null' status: type: - string - 'null' enum: - queued - planning - plan_review - running - generating_csv - uploading - completed - failed - cancelled - null turnCount: type: integer createdAt: type: - string - 'null' updatedAt: type: - string - 'null' effort: type: - string - 'null' enum: - low - medium - high - null spend: type: object properties: reservedCredits: type: integer settledCredits: type: integer capCredits: type: integer required: - reservedCredits - settledCredits - capCredits resultListId: type: - string - 'null' reportMarkdown: type: - string - 'null' errorCode: type: - string - 'null' enum: - ORCHESTRATOR_ERROR - ENGINE_MISCONFIGURED - HARNESS_NO_OUTPUT - STALE_TIMEOUT - SANDBOX_POOL_TIMEOUT - null cancelRequestedAt: type: - string - 'null' required: - runId - prompt - status - turnCount - createdAt - updatedAt - effort - spend - resultListId - reportMarkdown - errorCode - cancelRequestedAt required: - run example: run: runId: 68a205cc9c41d20014b40888 prompt: Series A fintech companies in Europe hiring a Head of Sales status: completed turnCount: 14 createdAt: '2026-08-25T10:00:00.000Z' updatedAt: '2026-08-25T10:11:48.000Z' effort: medium spend: reservedCredits: 0 settledCredits: 890 capCredits: 2000 resultListId: 68a205cc9c41d20014b40999 reportMarkdown: > # European fintech Series A 12 companies matched. Highlights: - **Northwind Pay** raised a $14M Series A in June and posted a Head of Sales role in Berlin. errorCode: null cancelRequestedAt: null '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. ````