• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
List timecards
V1
Square V1 APIs

We recommend using the Square API (V2) for all new development when possible. See When to use Connect V1 to learn more about working with V1 endpoints.

Deprecated
Effective February 26th, 2020

Provides summary information for all of a business's employee timecards.

Permissions
TIMECARDS_READ

Deprecation date
2020-02-26
Retirement date
2021-02-26
Replaced by
SearchShifts
Migration guide
Name Description
order
string

The order in which timecards are listed in the response, based on their created_at field.

employee_id
string

If provided, the endpoint returns only timecards for the employee with the specified ID.

begin_clockin_time
string

If filtering results by their clockin_time field, the beginning of the requested reporting period, in ISO 8601 format.

end_clockin_time
string

If filtering results by their clockin_time field, the end of the requested reporting period, in ISO 8601 format.

begin_clockout_time
string

If filtering results by their clockout_time field, the beginning of the requested reporting period, in ISO 8601 format.

end_clockout_time
string

If filtering results by their clockout_time field, the end of the requested reporting period, in ISO 8601 format.

begin_updated_at
string

If filtering results by their updated_at field, the beginning of the requested reporting period, in ISO 8601 format.

end_updated_at
string

If filtering results by their updated_at field, the end of the requested reporting period, in ISO 8601 format.

deleted
boolean

If true, only deleted timecards are returned. If false, only valid timecards are returned.If you don't provide this parameter, both valid and deleted timecards are returned.

limit
integer

The maximum integer number of employee entities to return in a single response. Default 100, maximum 200.

batch_token
string

A pagination cursor to retrieve the next set of results for your original query to the endpoint.

Response Fields

Name Description
items
Timecard [ ]

Examples

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

Share Feedback

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