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

# Get Execution Status

> Returns the status and progress of a scan execution. Use this to poll whether an execution has completed, track how many queries have been processed, and get an estimated time of completion for in-progress scans.



## OpenAPI

````yaml POST /get-execution-status
openapi: 3.1.0
info:
  title: Mindshare API
  description: >-
    The Mindshare API provides comprehensive access to brand visibility
    analytics, customer intelligence, and growth tracking. Use this API to
    retrieve customer data, query groups, execution results, domain insights,
    and actionable recommendations for improving your brand's AI visibility.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.mindshare.so/customer/v1
security:
  - apiKeyHeader: []
paths:
  /get-execution-status:
    post:
      description: >-
        Returns the status and progress of a scan execution. Use this to poll
        whether an execution has completed, track how many queries have been
        processed, and get an estimated time of completion for in-progress
        scans.
      requestBody:
        description: Execution ID
        content:
          application/json:
            schema:
              type: object
              properties:
                executionID:
                  type: number
                  description: The ID of the execution to check status for.
              required:
                - executionID
        required: true
      responses:
        '200':
          description: Execution status and progress
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionStatusResponse'
components:
  schemas:
    ExecutionStatusResponse:
      type: object
      properties:
        status:
          type: number
          description: HTTP status code
        data:
          type: object
          properties:
            execution_status:
              type: string
              enum:
                - Done
                - In Progress
              description: Either "Done" or "In Progress"
            progress:
              $ref: '#/components/schemas/ExecutionProgress'
            eta_hours:
              type: number
              nullable: true
              description: >-
                Estimated hours until completion. Null when status is "Done" or
                when ETA cannot be determined.
          required:
            - execution_status
            - progress
            - eta_hours
        version:
          type: string
          description: API version
        env:
          type: string
          description: Environment name
      required:
        - status
        - data
        - version
        - env
    ExecutionProgress:
      type: object
      properties:
        total:
          type: number
          description: Total number of queries in the execution
        completed:
          type: number
          description: Number of queries that have finished processing
      required:
        - total
        - completed
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````