---
updatedAt: 2026-05-12T09:58:23.000Z
---

# (Client) Retrieve current job instance

This operation returns an object containing information about the currently running instance (if any) for the specified job. The operation returns 404 (Not Found) if there is no instance currently running.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Job API (Legacy)",
    "contact": {},
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://sentinel.whitehatsec.com"
    }
  ],
  "paths": {
    "/api/{client_id}/job/{job_id}/instance/current": {
      "get": {
        "tags": [
          "Job API v1.0"
        ],
        "summary": "(Client) Retrieve current job instance",
        "description": "This operation returns an object containing information about the currently running instance (if any) for the specified job. The operation returns 404 (Not Found) if there is no instance currently running.",
        "operationId": "getClientCurrentInstance",
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "description": "The ID number of the desired Job resource.",
            "required": true,
            "style": "simple",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "client_id",
            "in": "path",
            "description": "Client ID.",
            "required": true,
            "style": "simple",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "format",
            "in": "query",
            "description": "Format of results.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "default": "xml",
              "example": "json",
              "enum": [
                "json",
                "xml",
                "csv"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Provides the information about current client job instance.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobInstance"
                }
              },
              "application/xml": {
                "example": "XML preview is currently not supported."
              },
              "text/csv, text/comma-separated-values": {
                "schema": {
                  "type": "string",
                  "description": "Column headers for data that may be returned using this format.",
                  "example": "id,begin,data,duration,end,href,job,name,requested_status,status,timestamp"
                }
              }
            }
          },
          "400": {
            "description": "BadRequestResponse indicates a request with invalid parameters.",
            "content": {}
          },
          "401": {
            "description": "UnauthorizedResponse signals an unauthorized API access.",
            "content": {}
          },
          "403": {
            "description": "ForbiddenResponse signals a request for a resource that does not exist or is not authorized.",
            "content": {}
          },
          "404": {
            "description": "NotFound the requested resource could not be found.",
            "content": {}
          },
          "500": {
            "description": "GenericError generic error.",
            "content": {}
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "JobInstance": {
        "properties": {
          "end": {
            "type": "number",
            "nullable": true
          },
          "requested_status": {
            "type": "string"
          },
          "begin": {
            "type": "number",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "data": {
            "type": "string",
            "nullable": true
          },
          "href": {
            "type": "string"
          },
          "timestamp": {
            "type": "number"
          },
          "id": {
            "type": "number"
          },
          "job": {
            "type": "number"
          },
          "duration": {
            "type": "number",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          }
        }
      }
    }
  },
  "x-explorer-enabled": false,
  "x-readme": {
    "proxy-enabled": true
  }
}
```