--- title: "GET /v1b3/projects/{projectId}/locations/{location}/jobs/{jobId}/executionDetails" method: GET path: "/v1b3/projects/{projectId}/locations/{location}/jobs/{jobId}/executionDetails" tags: ["projects"] --- # GET /v1b3/projects/{projectId}/locations/{location}/jobs/{jobId}/executionDetails `GET /v1b3/projects/{projectId}/locations/{location}/jobs/{jobId}/executionDetails` ## Request - Base URL: `https://dataflow.googleapis.com` - URL: `https://dataflow.googleapis.com/v1b3/projects/{projectId}/locations/{location}/jobs/{jobId}/executionDetails` - Auth: one of: - OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/cloud-platform` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform` - OAuth 2 and OAuth 2 - Implicit: `https://accounts.google.com/o/oauth2/auth` - Scopes: `https://www.googleapis.com/auth/compute` - Authorization code: `https://accounts.google.com/o/oauth2/auth` - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/compute` - TypeScript: (a function with typed inputs; its response is checked against the schema) Request detailed information about the execution status of the job. EXPERIMENTAL. This API is subject to change or removal without notice. # IAM Permissions Requires the `dataflow.metrics.get` permission on the job. ## Path parameters - `projectId` string, required - `location` string, required - `jobId` string, required ## Query parameters - `pageSize` integer - `pageToken` string ## Response `200` Successful response - JobExecutionDetails: Information about the execution of a job. - `nextPageToken` string: If present, this response does not contain all requested tasks. To obtain the next page of results, repeat the request with page_token set to this value. - `stages` StageSummary[]: The stages of the job execution. - `endTime` string, google-datetime: End time of this stage. If the work item is completed, this is the actual end time of the stage. Otherwise, it is the predicted end time. - `metrics` MetricUpdate[]: Metrics for this stage. - `boundedTrie` unknown - `cumulative` boolean: True if this metric is reported as the total cumulative aggregate value accumulated since the worker started working on this WorkItem. By default this is false, indicating that this metric is reported as a delta that is not associated with any WorkItem. - `distribution` unknown - `gauge` unknown - `internal` unknown - `kind` string: Metric aggregation kind. The possible metric aggregation kinds are "Sum", "Max", "Min", "Mean", "Set", "And", "Or", and "Distribution". The specified aggregation kind is case-insensitive. If omitted, this is not an aggregated value but instead a single metric sample value. - `meanCount` unknown - `meanSum` unknown - `name` MetricStructuredName: Identifies a metric, by describing the source which generated the metric. - `context` object: Zero or more labeled fields which identify the part of the job this metric is associated with, such as the name of a step or collection. For example, built-in counters associated with steps will have context['step'] = . Counters associated with PCollections in the SDK will have context['pcollection'] = . - `name` string: Worker-defined metric name. - `origin` string: Origin (namespace) of metric name. May be blank for user-define metrics; will be "dataflow" for metrics defined by the Dataflow service or SDK. - `scalar` unknown - `set` unknown - `trie` unknown - `updateTime` string, google-datetime: Timestamp associated with the metric value. Optional when workers are reporting work progress; it will be filled in responses from the metrics API. - `progress` ProgressTimeseries: Information about the progress of some component of job execution. - `currentProgress` number, double: The current progress of the component, in the range [0,1]. - `dataPoints` Point[]: History of progress for the component. Points are sorted by time. - `time` string, google-datetime: The timestamp of the point. - `value` number, double: The value of the point. - `stageId` string: ID of this stage - `startTime` string, google-datetime: Start time of this stage. - `state` 'EXECUTION_STATE_UNKNOWN' | 'EXECUTION_STATE_NOT_STARTED' | 'EXECUTION_STATE_RUNNING' | 'EXECUTION_STATE_SUCCEEDED' | 'EXECUTION_STATE_FAILED' | 'EXECUTION_STATE_CANCELLED': State of this stage. - `stragglerSummary` StragglerSummary: Summarized straggler identification details. - `recentStragglers` Straggler[]: The most recent stragglers. - `batchStraggler` StragglerInfo: Information useful for straggler identification and debugging. - `causes` object: The straggler causes, keyed by the string representation of the StragglerCause enum and contains specialized debugging information for each straggler cause. - `startTime` string, google-datetime: The time when the work item attempt became a straggler. - `streamingStraggler` StreamingStragglerInfo: Information useful for streaming straggler identification and debugging. - `dataWatermarkLag` string, google-duration: The event-time watermark lag at the time of the straggler detection. - `endTime` string, google-datetime: End time of this straggler. - `startTime` string, google-datetime: Start time of this straggler. - `systemWatermarkLag` string, google-duration: The system watermark lag at the time of the straggler detection. - `workerName` string: Name of the worker where the straggler was detected. - `stragglerCauseCount` object: Aggregated counts of straggler causes, keyed by the string representation of the StragglerCause enum. - `totalStragglerCount` string, int64: The total count of stragglers. ## Changes - **2026-10-21** `69a3fb1fef85`: 4 info - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2` - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c` - the security scope `https://www.googleapis.com/auth/compute` was removed from the endpoint's security scheme `Oauth2` - the security scope `https://www.googleapis.com/auth/compute` was removed from the endpoint's security scheme `Oauth2c` - **2026-10-15** `e94d44227b2e`: 4 info - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2` - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c` - the security scope `https://www.googleapis.com/auth/compute` was removed from the endpoint's security scheme `Oauth2` - the security scope `https://www.googleapis.com/auth/compute` was removed from the endpoint's security scheme `Oauth2c` - …earlier changes not shown [Operation history](https://skmtc.dev/google/apis/dataflow/changes/v1b3/projects/:projectId/locations/:location/jobs/:jobId/executionDetails/get.md) --- [API](https://skmtc.dev/google/apis/dataflow.md) - [All operations](https://skmtc.dev/google/apis/dataflow/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/dataflow/revisions/8dcb888104b7?raw)