---
title: "Create Company Punch Detail Operation"
method: POST
path: "/apiHub/time/v2/companies/{companyId}/punchDetails"
tags: ["Company Punch Details"]
---

# Create Company Punch Detail Operation

`POST /apiHub/time/v2/companies/{companyId}/punchDetails`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/time/v2/companies/{companyId}/punchDetails`
- Auth: HTTP bearer

**Summary Description**

The Company Punch Detail endpoint returns punch records for all employees within a specified company. Company Punch Detail endpoint represents the first step in a three-step process for retrieving punch details at the company level. Results can be limited by specifying a start date and end date. Date and time filtering uses the consumer's time zone and supports standard daily boundaries (00:00:00, 12:00:00, and 23:59:59).

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

**Use Cases**
- Retrieve punch details for all employees associated with a specific company ID.
- Narrow results to a defined timeframe by using the relativeStart and relativeEnd parameters.

## Path parameters

- `companyId` string, required

## Headers

- `Authorization` string, required

## Request body

- CompanyPunchDetailRequestBody
  - `relativeStart` string, date-time: The relative DateTime for the beginning of the WorkedShift. Value must not have timezone information.
  - `relativeEnd` string, date-time: The relative DateTime for the end of the WorkedShift. Value must not have timezone information.

## Response `202`

Accepted. This response has no body. Use the Location header value to retrieve the operation status and operationId in Step 2.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict. A pending operation already exists for this client and company.
- `429`: Too Many Requests
- `500`: Server Error

---

[API](https://skmtc.dev/paylocity/apis/punch-detail-api.md) - [All operations](https://skmtc.dev/paylocity/apis/punch-detail-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/punch-detail-api/revisions/7f0a1490bb93?raw)