---
title: "Get Punch Detail Operation"
method: GET
path: "/apiHub/time/v2/companies/{companyId}/punchDetailOperations/{operationId}"
tags: ["Company Punch Details"]
---

# Get Punch Detail Operation

`GET /apiHub/time/v2/companies/{companyId}/punchDetailOperations/{operationId}`

**Summary Description**

The Get Punch Detail Operation endpoint returns the status of an operation initiated in Step 1 of the punch details retrieval process. It indicates whether the operation is in progress, completed, or failed. This endpoint represents Step 2 in the process for retrieving punch details for all employees within a specified company ID. When the operation completes successfully, punch details can be retrieved in Step 3 using the resourceId from the final segment of the Location URL.

For information about the complete sequence, see the Punch Detail Overview or the Getting Started with Company Punch Details API recipe.

**Use Cases**
- Determine whether the operation is in progress, completed, or failed.
- Retrieve the resourceId after the successful completion of the operation by capturing the end of the location URL.

## Path parameters

- `companyId` string, required
- `operationId` string, uuid, required

## Query parameters

- `testFlag` boolean

## Headers

- `Authorization` string, required

## Response `200`

Success

- GetPunchDetailOperationModel
  - `status` 'succeeded' | 'failed' | 'running' | 'pending' — The current status of the operation.
  - `created` string, date-time — The date and time when the operation was created.
  - `lastUpdated` string, date-time — The date and time when the operation was last updated.
  - `location` string, nullable — The URL location where the punch detail data can be retrieved once the operation succeeds.
  - `errors` OperationIssue[], nullable — A list of errors that occurred during the operation, if any.
    - `employeeId` string, nullable — The employee ID associated with the issue, if applicable.
    - `date` string, date, nullable — The date associated with the issue, if applicable.
    - `message` string, nullable — A descriptive message about the issue.
  - `warnings` OperationIssue[], nullable — A list of warnings that occurred during the operation, if any.
    - `employeeId` string, nullable — The employee ID associated with the issue, if applicable.
    - `date` string, date, nullable — The date associated with the issue, if applicable.
    - `message` string, nullable — A descriptive message about the issue.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Server Error

---

[API](https://skmtc.net/paylocity/apis/assessments-api.md) · [All operations](https://skmtc.net/paylocity/apis/assessments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylocity/assessments-api/revisions/dd22ab229153/schema)