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

# Get HPC Job details

> Retrieve an HPC Job's details by its Id. Required permissions: `ViewJobs`



## OpenAPI

````yaml /api-specs/cloud/public-api.json get /api/hpc/v1/jobs/{jobId}
openapi: 3.0.3
info:
  title: Domino API
  description: Reference for Domino's public REST API endpoints.
  version: 6.4.0
servers:
  - url: https://mycluster.domino.tech
    description: >-
      Replace 'mycluster.domino.tech' with your Domino cluster hostname. For
      Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g.,
      acme.domino.tech). For self-hosted deployments, it is the hostname you
      reach the Domino UI at.
security:
  - DominoApiKey: []
  - BearerAuthentication: []
tags:
  - name: AppInstances
  - name: AppVersions
  - name: Apps
  - name: AsyncPredictions
  - name: AuditTrail
  - name: BillingTag
  - name: BillingTagSettings
  - name: Cost
  - name: CustomMetrics
  - name: DataSource
  - name: DatasetRw
  - name: DeploymentTargets
  - name: Environments
  - name: Extensions
  - name: GenAI
  - name: HPC Jobs
  - name: HardwareTier
  - name: Jobs
  - name: ModelAPI
  - name: ModelAPIVersion
  - name: ModelDeployment
  - name: Organizations
  - name: PPM
  - name: PersonalAccessToken
  - name: ProjectSharedDatasets
  - name: ProjectTemplates
  - name: Projects
  - name: ProjectsCommits
  - name: ProjectsFiles
  - name: RegisteredModels
  - name: ServiceAccounts
  - name: Users
  - name: Workspaces
paths:
  /api/hpc/v1/jobs/{jobId}:
    get:
      tags:
        - HPC Jobs
      summary: Get HPC Job details
      description: >-
        Retrieve an HPC Job's details by its Id. Required permissions:
        `ViewJobs`
      operationId: getHPCJobDetails
      parameters:
        - description: Id of HPC Job to retrieve details for
          in: path
          name: jobId
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HPCJobV1'
          description: Success
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
components:
  schemas:
    HPCJobV1:
      properties:
        dataPlaneId:
          $ref: '#/components/schemas/HPCDataPlaneRefV1'
        id:
          description: Id of the HPC Job.
          example: 6a17183ab03cb818f0f9c27b
          type: string
        jobRunCommand:
          description: The Slurm script / command the HPC Job ran.
          example: hello.sh
          type: string
        number:
          description: Sequential number of the HPC Job within the project.
          example: 1
          type: integer
        projectId:
          description: Id of the project the HPC Job belongs to.
          example: 6a17175ab03cb818f0f9c25f
          type: string
        requestedResources:
          $ref: '#/components/schemas/HPCRequestedResourcesV1'
        script:
          description: The contents of the Slurm script that the HPC job ran.
          example: echo 'Hello World'
          type: string
        stageTime:
          $ref: '#/components/schemas/HPCStageTimeV1'
        startedBy:
          $ref: '#/components/schemas/HPCStartedByV1'
        status:
          description: Current status of the HPC Job.
          example: Completed
          type: string
        tags:
          items:
            $ref: '#/components/schemas/HPCTagV1'
          type: array
        title:
          description: Name of the HPC Job.
          example: test1
          type: string
        usage:
          $ref: '#/components/schemas/HPCUsageV1'
      required:
        - number
        - id
        - title
        - projectId
        - jobRunCommand
        - stageTime
        - startedBy
        - status
        - tags
        - dataPlaneId
      type: object
    HPCDataPlaneRefV1:
      properties:
        id:
          description: Id of the data-plane the HPC Job ran on.
          example: '000000000000000000000000'
          type: string
        name:
          description: Name of the data-plane the HPC Job ran on.
          example: Local
          type: string
      required:
        - id
        - name
      type: object
    HPCRequestedResourcesV1:
      description: Resources requested at job submission time.
      properties:
        cpus:
          description: Total number of CPUs requested for the HPC Job.
          example: 4
          format: int64
          type: integer
        gpus:
          description: Total number of GPUs requested for the HPC Job.
          example: 1
          format: int64
          type: integer
        memory:
          description: Total memory requested for the HPC Job, in bytes.
          example: 8589934592
          format: int64
          type: integer
        nodes:
          description: Number of nodes requested for the HPC Job.
          example: 1
          format: int64
          type: integer
        timeLimit:
          description: >-
            Wall time limit for the HPC Job, in minutes (0 means unlimited or
            unset).
          example: 60
          format: int64
          type: integer
      type: object
    HPCStageTimeV1:
      properties:
        completedTime:
          description: Epoch time in milliseconds when the HPC Job completed.
          example: 1779899523770
          format: int64
          type: integer
        runStartTime:
          description: Epoch time in milliseconds when the HPC Job started running.
          example: 1779898520599
          format: int64
          type: integer
        submissionTime:
          description: Epoch time in milliseconds when the HPC Job was submitted.
          example: 1779898426846
          format: int64
          type: integer
      required:
        - submissionTime
      type: object
    HPCStartedByV1:
      properties:
        id:
          description: Id of the user who started the HPC Job.
          example: 6a162a2d063e69df3329c211
          type: string
        username:
          description: Username of the user who started the HPC Job.
          example: integration-test
          type: string
      required:
        - id
        - username
      type: object
    HPCTagV1:
      properties:
        name:
          description: Name of the tag.
          example: example
          type: string
        tagId:
          description: Id of the tag.
          example: example
          type: string
      required:
        - tagId
        - name
      type: object
    HPCUsageV1:
      properties:
        cpu:
          description: Max CPU usage for the HPC Job.
          example: 1.3193611323383083
          type: number
        memory:
          description: Max memory usage for the HPC Job, in bytes.
          example: 3473408
          type: number
      required:
        - cpu
        - memory
      type: object
    ErrorV1:
      properties:
        code:
          description: Machine-readable error code.
          example: NOT_FOUND
          type: string
        message:
          description: Human-readable description of the error.
          example: The requested HPC Job could not be found.
          type: string
      required:
        - message
      type: object
  responses:
    '400':
      content:
        application/json:
          schema:
            properties:
              error:
                type: string
            type: object
      description: Bad Request
    '401':
      content:
        application/json:
          example:
            code: UNAUTHORIZED
            message: Authentication is required to access this resource.
          schema:
            $ref: '#/components/schemas/ErrorV1'
      description: Unauthorized - authentication is required or has failed.
    '403':
      content:
        application/json:
          example:
            code: FORBIDDEN
            message: You do not have permission to perform this action.
          schema:
            $ref: '#/components/schemas/ErrorV1'
      description: Forbidden - the caller lacks permission to perform this action.
    '404':
      content:
        application/json:
          schema:
            properties:
              error:
                type: string
            type: object
      description: Not Found
    '500':
      content:
        application/json:
          schema:
            properties:
              error:
                type: string
            type: object
      description: Internal Server Error
  securitySchemes:
    DominoApiKey:
      type: apiKey
      in: header
      name: X-Domino-Api-Key
    BearerAuthentication:
      type: apiKey
      in: header
      name: Authorization

````

## Related topics

- [Get HPC Jobs for a project](/api-reference/hpc-jobs/get-hpc-jobs-for-a-project.md)
- [Get logs for an HPC Job](/api-reference/hpc-jobs/get-logs-for-an-hpc-job.md)
- [Get Job details](/api-reference/jobs/get-job-details.md)
- [Run HPC workloads with Slurm](/cloud/platform-capabilities/features/compute-clusters-hpc/slurm/index.md)
