You are viewing an old version of the API
Retrieve timecard
V1

Note We recommend using the Square API (V2) for all new development when possible.

Provides the details for a single timecard

Required permissions TIMECARDS_READ

Path Parameters

Name Description
timecard_id
string

Required

The timecard's ID.

Response Fields

Name Description
id
string

The timecard's unique ID.

employee_id
string

Required

The ID of the employee the timecard is associated with.

clockin_location_id
string

The ID of the location the employee clocked in from. We strongly reccomend providing a clockinlocationid. Square uses the clockinlocationid to determine a timecard’s timezone and overtime rules.

clockin_time
string

The clock-in time for the timecard, in ISO 8601 format.

clockout_location_id
string

The ID of the location the employee clocked out from. Provide this value only if importing timecard information from another system.

clockout_time
string

The clock-out time for the timecard, in ISO 8601 format. Provide this value only if importing timecard information from another system.

created_at
string

The time when the timecard was created, in ISO 8601 format.

deleted
boolean

If true, the timecard was deleted by the merchant, and it is no longer valid.

doubletime_seconds_worked
number

The total number of doubletime seconds worked in the timecard.

overtime_seconds_worked
number

The total number of overtime seconds worked in the timecard.

regular_seconds_worked
number

The total number of regular (non-overtime) seconds worked in the timecard.

updated_at
string

The time when the timecard was most recently updated, in ISO 8601 format.

Examples

You are viewing an old version of the API
GET /v1/me/timecards/{timecard_id}
cURL
  • cURL
curl https://connect.squareup.com/v1/me/timecards/{timecard_id} \
  -H 'Authorization: Bearer ACCESS_TOKEN'

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?