---
updatedAt: 2026-06-11T16:06:12.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# get

Fetch details of a job, including its configuration and status.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Jobs",
    "version": "v1beta1"
  },
  "tags": [
    {
      "name": "tamr.api.v1beta1.Jobs"
    }
  ],
  "paths": {
    "/api/v1beta1/jobs/{jobId}": {
      "get": {
        "summary": "get",
        "description": "Fetch details of a job, including its configuration and status.",
        "operationId": "Jobs_GetJob",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/tamr.api.v1beta1.Job"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "jobId",
            "description": "Required. ID of the job to fetch.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "tamr.api.v1beta1.Jobs"
        ]
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-API-KEY",
        "value": "example-api-key"
      }
    ]
  },
  "servers": [
    {
      "url": "https://api-examples.tamr.cloud"
    }
  ],
  "components": {
    "schemas": {
      "tamr.api.v1beta1.Error": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "description": "A short error code that summarizes the error. This is a constant value that identifies the cause of the error.\nThis should be at most 63 characters and match a regular expression of `[A-Z][A-Z0-9_]+[A-Z0-9]`, which represents\nUPPER_SNAKE_CASE.",
            "readOnly": true
          },
          "message": {
            "type": "string",
            "description": "A human-readable description of the error. Error messages should be concise and helpful, providing specifics about\nthe problem when appropriate and suggesting next steps to resolve. Error messages should not expose sensitive\ninformation about system internals.",
            "readOnly": true
          }
        }
      },
      "tamr.api.v1beta1.Job": {
        "type": "object",
        "properties": {
          "jobId": {
            "type": "string",
            "description": "Output only. ID of the job.",
            "readOnly": true
          },
          "configuration": {
            "description": "Required. What the job does.",
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1beta1.JobConfiguration"
              }
            ]
          },
          "status": {
            "description": "Output only. Current status of the job.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1beta1.JobStatus"
              }
            ]
          },
          "statusHistory": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/tamr.api.v1beta1.JobStatus"
            },
            "description": "Output only. Past statuses of the job.",
            "readOnly": true
          }
        },
        "description": "Describes configuration and status of a job.",
        "required": [
          "configuration"
        ]
      },
      "tamr.api.v1beta1.JobConfiguration": {
        "type": "object",
        "properties": {
          "load": {
            "$ref": "#/components/schemas/tamr.api.v1beta1.JobConfiguration.LoadJob"
          },
          "update": {
            "$ref": "#/components/schemas/tamr.api.v1beta1.JobConfiguration.UpdateJob"
          },
          "publish": {
            "$ref": "#/components/schemas/tamr.api.v1beta1.JobConfiguration.PublishJob"
          }
        },
        "description": "Required. Set only one type. What the job does."
      },
      "tamr.api.v1beta1.JobConfiguration.LoadJob": {
        "type": "object",
        "properties": {
          "sourceId": {
            "type": "string",
            "description": "Required. Source to load."
          }
        },
        "description": "Load source data.",
        "required": [
          "sourceId"
        ]
      },
      "tamr.api.v1beta1.JobConfiguration.PublishJob": {
        "type": "object",
        "properties": {
          "destinationId": {
            "type": "string",
            "description": "Required. Destination to refresh."
          },
          "dataProductId": {
            "type": "string",
            "description": "Optional for legacy Data Products only. Data product to publish."
          }
        },
        "description": "[Pick one] Publish data to a destination.",
        "required": [
          "destinationId"
        ]
      },
      "tamr.api.v1beta1.JobConfiguration.UpdateJob": {
        "type": "object",
        "properties": {
          "dataProductId": {
            "type": "string",
            "description": "Data product to update."
          },
          "workflowId": {
            "type": "string",
            "description": "Workflow to run."
          }
        },
        "description": "[Pick one] Run a data product flow to update results or a workflow to update a system of records."
      },
      "tamr.api.v1beta1.JobState": {
        "type": "string",
        "example": "RUNNING",
        "enum": [
          "STATE_UNSPECIFIED",
          "PENDING",
          "RUNNING",
          "STOPPING",
          "DONE"
        ],
        "default": "STATE_UNSPECIFIED",
        "description": "Represents the lifecycle of a job.\n\n - STATE_UNSPECIFIED: Default value. The job state value is unset. This value should not be used.\n - PENDING: The job has been received but has not begun to execute.\n - RUNNING: The job is actively executing.\n - STOPPING: A signal to stop has been received, but the job is still running.\n - DONE: The job is done."
      },
      "tamr.api.v1beta1.JobStatus": {
        "type": "object",
        "properties": {
          "state": {
            "description": "Output only. State of job execution.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1beta1.JobState"
              }
            ]
          },
          "stateStartTime": {
            "type": "string",
            "format": "date-time",
            "description": "Output only. Time when the job entered this state.",
            "readOnly": true
          },
          "error": {
            "description": "Optional. Output only. If present, indicates that the job is done and was unsuccessful.",
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/tamr.api.v1beta1.Error"
              }
            ]
          }
        },
        "description": "Output only. Describes execution status and errors.",
        "readOnly": true
      }
    }
  }
}
```