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

# Get job execution

> Returns detailed information about a specific job execution including status, task statistics (success/failure/running counts), and timing information.



## OpenAPI

````yaml /api-reference/controlplane.yml get /jobs/{jobId}/executions/{executionId}
openapi: 3.0.3
info:
  title: Blaxel Control Plane
  version: 0.0.1
servers:
  - description: Blaxel Control Plane
    url: https://api.blaxel.ai/v0
  - description: Blaxel Inference
    url: https://run.blaxel.ai
security:
  - OAuth2:
      - admin
  - ApiKeyAuth: []
paths:
  /jobs/{jobId}/executions/{executionId}:
    get:
      tags:
        - jobs
      summary: Get job execution
      description: >-
        Returns detailed information about a specific job execution including
        status, task statistics (success/failure/running counts), and timing
        information.
      operationId: GetJobExecution
      parameters:
        - description: Name of the job
          in: path
          name: jobId
          required: true
          schema:
            type: string
        - description: Id of the execution
          in: path
          name: executionId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobExecution'
          description: successful operation
        '400':
          description: bad request
        '404':
          description: execution not found
        '500':
          description: internal server error
      security:
        - OAuth2:
            - jobs:get
        - ApiKeyAuth: []
components:
  schemas:
    JobExecution:
      type: object
      description: Job execution
      properties:
        metadata:
          $ref: '#/components/schemas/JobExecutionMetadata'
        spec:
          $ref: '#/components/schemas/JobExecutionSpec'
        stats:
          $ref: '#/components/schemas/JobExecutionStats'
        status:
          $ref: '#/components/schemas/JobExecutionStatus'
        tasks:
          type: array
          description: List of execution tasks
          items:
            $ref: '#/components/schemas/JobExecutionTask'
      required:
        - metadata
        - spec
    JobExecutionMetadata:
      type: object
      description: Job execution metadata
      properties:
        cluster:
          type: string
          description: Cluster ID
        completedAt:
          type: string
          description: Completion timestamp
        createdAt:
          type: string
          description: Creation timestamp
        deletedAt:
          type: string
          description: Deletion timestamp
        expiredAt:
          type: string
          description: Expiration timestamp
        id:
          type: string
          description: Execution ID
          example: exec-abc123
        job:
          type: string
          description: Job name
          example: data-processing-job
        startedAt:
          type: string
          description: Start timestamp
        updatedAt:
          type: string
          description: Last update timestamp
        workspace:
          type: string
          description: Workspace ID
          example: my-workspace
      readOnly: true
    JobExecutionSpec:
      type: object
      description: Job execution specification
      properties:
        envOverride:
          type: object
          description: >-
            Environment variable overrides (if provided for this execution,
            values are masked with ***)
          example: '{"MY_VAR": "***", "BATCH_SIZE": "***"}'
        memoryOverride:
          type: integer
          description: Memory override in megabytes (if provided for this execution)
          example: 2048
        parallelism:
          type: integer
          description: Number of parallel tasks
          example: 5
        tasks:
          type: array
          description: List of execution tasks
          items:
            $ref: '#/components/schemas/JobExecutionTask'
        timeout:
          type: integer
          description: Job timeout in seconds (captured at execution creation time)
          example: 3600
    JobExecutionStats:
      type: object
      description: Job execution statistics
      properties:
        cancelled:
          type: integer
          description: Number of cancelled tasks
          example: 0
        failure:
          type: integer
          description: Number of failed tasks
          example: 1
        retried:
          type: integer
          description: Number of retried tasks
          example: 2
        running:
          type: integer
          description: Number of running tasks
          example: 1
        success:
          type: integer
          description: Number of successful tasks
          example: 8
        total:
          type: integer
          description: Total number of tasks
          example: 10
      readOnly: true
    JobExecutionStatus:
      type: string
      description: Job execution status
      enum:
        - queued
        - pending
        - running
        - cancelling
        - cancelled
        - failed
        - succeeded
        - timeout
    JobExecutionTask:
      type: object
      description: Job execution task
      properties:
        conditions:
          type: array
          description: Task conditions
          items:
            $ref: '#/components/schemas/JobExecutionTaskCondition'
        metadata:
          $ref: '#/components/schemas/JobExecutionTaskMetadata'
        spec:
          $ref: '#/components/schemas/JobExecutionTaskSpec'
        status:
          $ref: '#/components/schemas/JobExecutionTaskStatus'
    JobExecutionTaskCondition:
      type: object
      description: Job execution task condition
      properties:
        executionReason:
          type: string
          description: Execution reason
        message:
          type: string
          description: Condition message
        reason:
          type: string
          description: Condition reason
        severity:
          type: string
          description: Condition severity
        state:
          type: string
          description: Condition state
        type:
          type: string
          description: Condition type
    JobExecutionTaskMetadata:
      type: object
      description: Job execution task metadata
      properties:
        completedAt:
          type: string
          description: Completion timestamp
          readOnly: true
        createdAt:
          type: string
          description: Creation timestamp
          readOnly: true
        name:
          type: string
          description: Task name
          example: task-0
        scheduledAt:
          type: string
          description: Scheduled timestamp
          readOnly: true
        startedAt:
          type: string
          description: Start timestamp
          readOnly: true
        updatedAt:
          type: string
          description: Last update timestamp
          readOnly: true
    JobExecutionTaskSpec:
      type: object
      description: Job execution task specification
      properties:
        maxRetries:
          type: integer
          description: Maximum number of retries
          example: 3
        timeout:
          type: string
          description: Task timeout duration
          example: 30m
    JobExecutionTaskStatus:
      type: string
      description: Job execution task status
      enum:
        - unspecified
        - pending
        - reconciling
        - failed
        - succeeded
        - running
        - cancelled
  securitySchemes:
    OAuth2:
      description: OAuth2 authentication with JWT tokens
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize
          scopes:
            admin: Administrative access
            agents:create: Create agents
            agents:delete: Delete agents
            agents:get: Get agent details
            agents:list: List agents
            agents:update: Update agents
            apiKey:list: List API keys
            apiKey:write: Create and delete API keys
            configurations:list: List configurations
            customdomains:create: Create custom domains
            customdomains:delete: Delete custom domains
            customdomains:get: Get custom domain details
            customdomains:list: List custom domains
            customdomains:update: Update custom domains
            functions:create: Create functions
            functions:delete: Delete functions
            functions:get: Get function details
            functions:list: List functions
            functions:update: Update functions
            integrations:create: Create integrations
            integrations:list: List integrations
            invitations:list: List invitations
            jobs:create: Create jobs
            jobs:delete: Delete jobs
            jobs:get: Get job details
            jobs:list: List jobs
            jobs:update: Update jobs
            locations:list: List locations
            mcphub:list: List MCP hub resources
            models:create: Create models
            models:delete: Delete models
            models:get: Get model details
            models:list: List models
            models:update: Update models
            policies:create: Create policies
            policies:delete: Delete policies
            policies:get: Get policy details
            policies:list: List policies
            policies:update: Update policies
            sandboxes:control: Control sandbox operations
            sandboxes:create: Create sandboxes
            sandboxes:delete: Delete sandboxes
            sandboxes:get: Get sandbox details
            sandboxes:list: List sandboxes
            sandboxes:update: Update sandboxes
            sandboxhub:list: List sandbox hub resources
            templates:get: Get template details
            templates:list: List templates
            volumeTemplates:create: Create volume templates
            volumeTemplates:delete: Delete volume templates
            volumeTemplates:get: Get volume template details
            volumeTemplates:list: List volume templates
            volumeTemplates:upsert: Create or update volume templates
            volumes:create: Create volumes
            volumes:delete: Delete volumes
            volumes:get: Get volume details
            volumes:list: List volumes
            workspaces:accept: Accept workspace invitation
            workspaces:create: Create workspaces
            workspaces:decline: Decline workspace invitation
            workspaces:delete: Delete workspaces
            workspaces:get: Get workspace details
            workspaces:invite: Invite users to workspace
            workspaces:leave: Leave workspace
            workspaces:list: List workspaces
            workspaces:remove: Remove users from workspace
            workspaces:update: Update workspaces
          tokenUrl: /oauth/token
        clientCredentials:
          scopes:
            admin: Administrative access
            agents:create: Create agents
            agents:delete: Delete agents
            agents:get: Get agent details
            agents:list: List agents
            agents:update: Update agents
            apiKey:list: List API keys
            apiKey:write: Create and delete API keys
            configurations:list: List configurations
            customdomains:create: Create custom domains
            customdomains:delete: Delete custom domains
            customdomains:get: Get custom domain details
            customdomains:list: List custom domains
            customdomains:update: Update custom domains
            functions:create: Create functions
            functions:delete: Delete functions
            functions:get: Get function details
            functions:list: List functions
            functions:update: Update functions
            integrations:create: Create integrations
            integrations:list: List integrations
            invitations:list: List invitations
            jobs:create: Create jobs
            jobs:delete: Delete jobs
            jobs:get: Get job details
            jobs:list: List jobs
            jobs:update: Update jobs
            locations:list: List locations
            mcphub:list: List MCP hub resources
            models:create: Create models
            models:delete: Delete models
            models:get: Get model details
            models:list: List models
            models:update: Update models
            policies:create: Create policies
            policies:delete: Delete policies
            policies:get: Get policy details
            policies:list: List policies
            policies:update: Update policies
            sandboxes:control: Control sandbox operations
            sandboxes:create: Create sandboxes
            sandboxes:delete: Delete sandboxes
            sandboxes:get: Get sandbox details
            sandboxes:list: List sandboxes
            sandboxes:update: Update sandboxes
            sandboxhub:list: List sandbox hub resources
            templates:get: Get template details
            templates:list: List templates
            volumeTemplates:create: Create volume templates
            volumeTemplates:delete: Delete volume templates
            volumeTemplates:get: Get volume template details
            volumeTemplates:list: List volume templates
            volumeTemplates:upsert: Create or update volume templates
            volumes:create: Create volumes
            volumes:delete: Delete volumes
            volumes:get: Get volume details
            volumes:list: List volumes
            workspaces:accept: Accept workspace invitation
            workspaces:create: Create workspaces
            workspaces:decline: Decline workspace invitation
            workspaces:delete: Delete workspaces
            workspaces:get: Get workspace details
            workspaces:invite: Invite users to workspace
            workspaces:leave: Leave workspace
            workspaces:list: List workspaces
            workspaces:remove: Remove users from workspace
            workspaces:update: Update workspaces
          tokenUrl: /oauth/token
      type: oauth2
    ApiKeyAuth:
      bearerFormat: API Key
      description: Long-lived API key for programmatic access
      scheme: bearer
      type: http

````