You are viewing an old version of the API

All Versions

Search shifts

POST /v2/labor/shifts/search

Returns a paginated list of Shift records for a business.

The list to be returned can be filtered by:

Location IDs and
employee IDs and
shift status (OPEN, CLOSED) and
shift start and
shift end and
work day details

The list can be sorted by:

start_at
end_at
created_at
updated_at

Permissions

TIMECARDS_READ

Try in API Explorer

Request Body

Example code

Name	Description
`query ShiftQuery`	Query filters.
`limit integer (32-bit)`	number of resources in a page (200 by default). Min 1 Max 200
`cursor string`	opaque cursor for fetching the next page.

Response Fields

Name	Description
`shifts Shift [ ]`	Shifts
`cursor string`	Opaque cursor for fetching the next page.
`errors Error [ ]`	Any errors that occurred during the request.

Examples

curl https://connect.squareup.com/v2/labor/shifts/search \
  -X POST \
  -H 'Square-Version: 2021-03-17' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": {
      "filter": {
        "workday": {
          "date_range": {
            "start_date": "2019-01-20",
            "end_date": "2019-02-03"
          },
          "match_shifts_by": "START_AT",
          "default_timezone": "America/Los_Angeles"
        }
      }
    },
    "limit": 100
  }'

{
  "shifts": [
    {
      "id": "X714F3HA6D1PT",
      "team_member_id": "ormj0jJJZ5OZIzxrZYJI",
      "employee_id": "ormj0jJJZ5OZIzxrZYJI",
      "location_id": "PAA1RJZZKXBFG",
      "timezone": "America/New_York",
      "start_at": "2019-01-21T03:11:00-05:00",
      "end_at": "2019-01-21T13:11:00-05:00",
      "wage": {
        "title": "Barista",
        "hourly_rate": {
          "amount": 1100,
          "currency": "USD"
        }
      },
      "breaks": [
        {
          "id": "SJW7X6AKEJQ65",
          "start_at": "2019-01-21T06:11:00-05:00",
          "end_at": "2019-01-21T06:11:00-05:00",
          "break_type_id": "REGS1EQR1TPZ5",
          "name": "Tea Break",
          "expected_duration": "PT10M",
          "is_paid": true
        }
      ],
      "status": "CLOSED",
      "version": 6,
      "created_at": "2019-01-24T01:12:03Z",
      "updated_at": "2019-02-07T22:21:08Z"
    },
    {
      "id": "GDHYBZYWK0P2V",
      "team_member_id": "33fJchumvVdJwxV0H6L9",
      "employee_id": "33fJchumvVdJwxV0H6L9",
      "location_id": "PAA1RJZZKXBFG",
      "timezone": "America/New_York",
      "start_at": "2019-01-22T12:02:00-05:00",
      "end_at": "2019-01-22T13:02:00-05:00",
      "wage": {
        "title": "Cook",
        "hourly_rate": {
          "amount": 1600,
          "currency": "USD"
        }
      },
      "breaks": [
        {
          "id": "BKS6VR7WR748A",
          "start_at": "2019-01-23T14:30:00-05:00",
          "end_at": "2019-01-23T14:40:00-05:00",
          "break_type_id": "WQX00VR99F53J",
          "name": "Tea Break",
          "expected_duration": "PT10M",
          "is_paid": true
        },
        {
          "id": "BQFEZSHFZSC51",
          "start_at": "2019-01-22T12:30:00-05:00",
          "end_at": "2019-01-22T12:44:00-05:00",
          "break_type_id": "P6Q468ZFRN1AC",
          "name": "Coffee Break",
          "expected_duration": "PT15M",
          "is_paid": false
        }
      ],
      "status": "CLOSED",
      "version": 16,
      "created_at": "2019-01-23T23:32:45Z",
      "updated_at": "2019-01-24T00:56:25Z"
    }
  ]
}

Labor API You are viewing an old version of the API 2021-03-17 Version 2021-03-17 All Versions Labor API Search shifts

Request Body

Response Fields

Examples

Share Feedback

You are viewing an old version of the API

All Versions

Search shifts