> ## Documentation Index
> Fetch the complete documentation index at: https://developers.luccasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a time-punch

> Returns a single time-punch, archived or not.



## OpenAPI

````yaml /openapi-specs/timmi-timesheet.yaml get /timmi-timesheet/api/time-punches/{id}
openapi: 3.1.0
info:
  title: Lucca Timesheet API (not v3)
  version: '1.0'
  description: The latest documentation for Lucca Timesheet API.
  contact:
    name: API Support
    url: https://www.luccasoftware.com
    email: no-reply@luccasoftware.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
  - url: https://{host}
    description: Your Lucca account URL.
    variables:
      host:
        default: example.ilucca.net
        description: >-
          The URL of your dedicated Lucca account: `{account}.{env}.{region}`.


          Account reflects your company name. Env indicates the environment.
          Region depends on your server location.


          **Please, use your test or sandbox environments (and not your
          production env.) for testing purposes.**


          **Please, use your test or sandbox environments (and not your
          production env.) for testing purposes.**


          Environments:

          - `ilucca`: production environment for customers.

          - `ilucca-test`: test environment for customers.

          - `ilucca-demo`: demo environment for prospects.


          Regions:

          - `.ch` for Swiss located accounts.

          - `.net` for the others.


          Regarding sandboxes, the pattern differs:
          `https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com`,
          where:

          - `{sandboxName}` is automatically generated upon creation.

          - `{server}` may be "eu1", "eu2" or "ch1".
security: []
tags:
  - name: TimeEntries
    description: TimeEntries are the actual working hours observed by a user.
  - name: Workflow
    description: All actions regarding the approval process of timesheets.
  - name: TimePunches
    description: TimePunches are the clock-ins and clock-outs of employees.
paths:
  /timmi-timesheet/api/time-punches/{id}:
    parameters:
      - $ref: '#/components/parameters/Authorization'
      - name: id
        in: path
        required: true
        description: Unique identifier of the time-punch.
        schema:
          type: string
    get:
      tags:
        - TimePunches
      summary: Get a time-punch
      description: Returns a single time-punch, archived or not.
      operationId: get-timmi-timesheet-api-time-punch
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TimePunch'
        '401':
          description: Unauthorized. The API key is missing or invalid.
        '404':
          description: >-
            Not Found. The time-punch does not exist, or the API key has no
            access to it.
components:
  parameters:
    Authorization:
      name: Authorization
      required: true
      description: 'API key. Value must be formatted like so: `lucca application={api_key}`.'
      in: header
      schema:
        type: string
  schemas:
    TimePunch:
      title: TimePunch
      type: object
      description: A clock-in or clock-out of an employee.
      properties:
        id:
          type: string
          description: Unique identifier of the time-punch.
          example: '93874'
        type:
          type: string
          const: time-punch
        url:
          type: string
          format: uri
          example: https://example.ilucca.net/timmi-timesheet/api/time-punches/93874
        employee:
          type: object
          description: The employee who clocked in or out.
          properties:
            id:
              type: string
              example: '416'
            type:
              type: string
              const: employee
            url:
              type: string
              format: uri
              example: https://example.ilucca.net/lucca-api/employees/416
        resolvedTime:
          type: string
          format: date-time
          example: '2026-10-22T08:04:23+02:00'
          description: >-
            The date and time when the employee clocked in or out, with the
            offset of the time zone of the employee's establishment. For a
            time-punch created with an API key, it is the `clientWalledTime`
            sent, resolved in that time zone.
        direction:
          type: string
          enum:
            - in
            - out
          description: Whether the time-punch is a clock-in (`in`) or a clock-out (`out`).
        source:
          type: string
          enum:
            - integration
            - desktop
            - mobileApp
            - lucca
          description: >-
            The system the time-punch came from:

            - `integration`: a punch clock integrated with an API key, such as
            your own.

            - `desktop`: Lucca virtual punch clock, from a web browser.

            - `mobileApp`: Lucca virtual punch clock, from the mobile app.

            - `lucca`: a Lucca punch clock.
        isManual:
          type: boolean
          description: >-
            Whether the time-punch was entered by hand rather than produced by a
            punch clock.
        isArchived:
          type: boolean
          description: >-
            Whether the time-punch is archived. Archived time-punches are no
            longer taken into account to compute worked time.
        createdAt:
          type: string
          format: date-time
          example: '2026-10-22T06:04:25.1234567+00:00'
          description: Date and time the time-punch was created in Lucca, with offset.

````

## Related topics

- [List time-punches](https://developers.luccasoftware.com/api-reference/legacy/timmi-timesheet/time-punches/list-time-punches.md)
- [How to Send Time-Punches from Your Own Punch Clock](https://developers.luccasoftware.com/api-reference/legacy/timmi-timesheet/guides/send-time-punches.md)
- [Create a time-punch](https://developers.luccasoftware.com/api-reference/legacy/timmi-timesheet/time-punches/create-time-punch.md)
- [The time-punch resource](https://developers.luccasoftware.com/api-reference/legacy/timmi-timesheet/time-punches/time-punch.md)
- [Archive or restore a time-punch](https://developers.luccasoftware.com/api-reference/legacy/timmi-timesheet/time-punches/archive-time-punch.md)