Get a time-punch - Lucca API

Documentation

Files

Organization Structure API

Core HR API

Recruitment API

Expenses API

Invoices API

Absences API

Office API

Project API

Schedule API

Timesheet API

Mealvouchers API

Compensation API

Training API

Get a time-punch

curl --request GET \
  --url https://{host}/timmi-timesheet/api/time-punches/{id} \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://{host}/timmi-timesheet/api/time-punches/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/timmi-timesheet/api/time-punches/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/timmi-timesheet/api/time-punches/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{host}/timmi-timesheet/api/time-punches/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "id": "93874",
  "type": "time-punch",
  "url": "https://example.ilucca.net/timmi-timesheet/api/time-punches/93874",
  "employee": {
    "id": "416",
    "type": "employee",
    "url": "https://example.ilucca.net/lucca-api/employees/416"
  },
  "resolvedTime": "2026-10-22T08:04:23+02:00",
  "direction": "in",
  "source": "integration",
  "isManual": true,
  "isArchived": true,
  "createdAt": "2026-10-22T06:04:25.1234567+00:00"
}

GET

/

timmi-timesheet

/

api

/

time-punches

/

{id}

Get a time-punch

curl --request GET \
  --url https://{host}/timmi-timesheet/api/time-punches/{id} \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://{host}/timmi-timesheet/api/time-punches/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/timmi-timesheet/api/time-punches/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/timmi-timesheet/api/time-punches/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{host}/timmi-timesheet/api/time-punches/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "id": "93874",
  "type": "time-punch",
  "url": "https://example.ilucca.net/timmi-timesheet/api/time-punches/93874",
  "employee": {
    "id": "416",
    "type": "employee",
    "url": "https://example.ilucca.net/lucca-api/employees/416"
  },
  "resolvedTime": "2026-10-22T08:04:23+02:00",
  "direction": "in",
  "source": "integration",
  "isManual": true,
  "isArchived": true,
  "createdAt": "2026-10-22T06:04:25.1234567+00:00"
}

Headers

Authorization

string

required

API key. Value must be formatted like so: lucca application={api_key}.

Path Parameters

id

string

required

Unique identifier of the time-punch.

Response

OK

A clock-in or clock-out of an employee.

id

string

Unique identifier of the time-punch.

Example:

"93874"

type

string

Allowed value: "time-punch"

url

string<uri>

Example:

"https://example.ilucca.net/timmi-timesheet/api/time-punches/93874"

employee

object

The employee who clocked in or out.

Show child attributes

resolvedTime

string<date-time>

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.

Example:

"2026-10-22T08:04:23+02:00"

direction

enum<string>

Whether the time-punch is a clock-in (in) or a clock-out (out).

Available options:

in,

out

source

enum<string>

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.

Available options:

integration,

desktop,

mobileApp,

lucca

isManual

boolean

Whether the time-punch was entered by hand rather than produced by a punch clock.

isArchived

boolean

Whether the time-punch is archived. Archived time-punches are no longer taken into account to compute worked time.

createdAt

string<date-time>

Date and time the time-punch was created in Lucca, with offset.

Example:

"2026-10-22T06:04:25.1234567+00:00"