Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

    Team

  • Create team member

  • Bulk create team members

  • Bulk update team members

  • List jobs

  • Create job

  • Retrieve job

  • Update job

  • Search team members

  • Retrieve team member

  • Update team member

  • Retrieve wage setting

  • Update wage setting

  • Webhooks

  • job.created

  • job.updated

  • team_member.created

  • team_member.updated

  • team_member.wage_setting.updated

<- Team API

Team API

All versions ->

Search team members

POST

 /v2/team-members/search

Returns a paginated list of TeamMember objects for a business.

The list can be filtered by location IDs, ACTIVE or INACTIVE status, or whether the team member is the Square account owner.

Permissions:EMPLOYEES_READ

Guide

Search for team members

Try in API Explorer
Link to section

Request body

Example code

Link to section

query

The query parameters.

Link to section

limit

integer(32-bit)

The maximum number of TeamMember objects in a page (100 by default).

Min
1
Max
200
Link to section

cursor

string

The opaque cursor for fetching the next page. For more information, see pagination.

Link to section

Response fields

Link to section

team_members

The filtered list of TeamMember objects.

Link to section

cursor

string

The opaque cursor for fetching the next page. For more information, see pagination.

Link to section

errors

The errors that occurred during the request.

Link to section

Examples

All versions ->

POST /v2/team-members/search
curl https://connect.squareup.com/v2/team-members/search \ -X POST \ -H 'Square-Version: 2026-09-16' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "query": { "filter": { "location_ids": [ "0G5P3VGACMMQZ" ], "status": "ACTIVE" } }, "limit": 10 }'

Response JSON

{ "team_members": [ { "id": "-3oZQKPKVk6gUXU_V5Qa", "reference_id": "12345678", "is_owner": false, "status": "ACTIVE", "given_name": "Johnny", "family_name": "Cash", "email_address": "[email protected]", "created_at": "2019-07-10T17:26:48Z", "updated_at": "2020-04-28T21:49:28Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" }, "wage_setting": { "team_member_id": "-3oZQKPKVk6gUXU_V5Qa", "job_assignments": [ { "job_title": "Manager", "job_id": "FjS8x95cqHiMenw4f1NAUH4P", "pay_type": "SALARY", "hourly_rate": { "amount": 1443, "currency": "USD" }, "annual_rate": { "amount": 3000000, "currency": "USD" }, "weekly_hours": 40 }, { "job_title": "Cashier", "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 2000, "currency": "USD" } } ], "is_overtime_exempt": true, "version": 1, "created_at": "2021-06-11T22:55:45Z", "updated_at": "2021-06-11T22:55:45Z" } }, { "id": "1AVJj0DjkzbmbJw5r4KK", "reference_id": "abcded", "is_owner": false, "status": "ACTIVE", "given_name": "Lombard", "family_name": "Smith", "phone_number": "+14155552671", "created_at": "2020-03-24T18:14:01Z", "updated_at": "2020-06-09T17:38:05Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" }, "wage_setting": { "team_member_id": "1AVJj0DjkzbmbJw5r4KK", "job_assignments": [ { "job_title": "Cashier", "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 2400, "currency": "USD" } } ], "is_overtime_exempt": true, "version": 2, "created_at": "2020-03-24T18:14:01Z", "updated_at": "2020-06-09T17:38:05Z" } }, { "id": "2JCmiJol_KKFs9z2Evim", "is_owner": false, "status": "ACTIVE", "given_name": "Monica", "family_name": "Sway", "created_at": "2020-03-24T01:09:25Z", "updated_at": "2020-03-24T01:11:25Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" }, "wage_setting": { "team_member_id": "2JCmiJol_KKFs9z2Evim", "job_assignments": [ { "job_title": "Cashier", "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 2400, "currency": "USD" } } ], "is_overtime_exempt": true, "version": 1, "created_at": "2020-03-24T01:09:25Z", "updated_at": "2020-03-24T01:09:25Z" } }, { "id": "4uXcJQSLtbk3F0UQHFNQ", "is_owner": false, "status": "ACTIVE", "given_name": "Elton", "family_name": "Ipsum", "created_at": "2020-03-24T01:09:23Z", "updated_at": "2020-03-24T01:15:23Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" } }, { "id": "5CoUpyrw1YwGWcRd-eDL", "is_owner": false, "status": "ACTIVE", "given_name": "Steven", "family_name": "Lo", "created_at": "2020-03-24T01:09:23Z", "updated_at": "2020-03-24T01:19:23Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" } }, { "id": "5MRPTTp8MMBLVSmzrGha", "is_owner": false, "status": "ACTIVE", "given_name": "Patrick", "family_name": "Steward", "phone_number": "+14155552671", "created_at": "2020-03-24T18:14:03Z", "updated_at": "2020-03-24T18:18:03Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" }, "wage_setting": { "team_member_id": "5MRPTTp8MMBLVSmzrGha", "job_assignments": [ { "job_title": "Cashier", "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 2000, "currency": "USD" } } ], "is_overtime_exempt": true, "version": 1, "created_at": "2020-03-24T18:14:03Z", "updated_at": "2020-03-24T18:14:03Z" } }, { "id": "7F5ZxsfRnkexhu1PTbfh", "is_owner": false, "status": "ACTIVE", "given_name": "Ivy", "family_name": "Manny", "created_at": "2020-03-24T01:09:25Z", "updated_at": "2020-03-24T01:09:25Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" } }, { "id": "808X9HR72yKvVaigQXf4", "is_owner": false, "status": "ACTIVE", "given_name": "John", "family_name": "Smith", "email_address": "[email protected]", "phone_number": "+14155552671", "created_at": "2020-03-24T18:14:02Z", "updated_at": "2020-03-24T18:14:02Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" } }, { "id": "9MVDVoY4hazkWKGo_OuZ", "is_owner": false, "status": "ACTIVE", "given_name": "Robert", "family_name": "Wen", "email_address": "[email protected]", "phone_number": "+14155552671", "created_at": "2020-03-24T18:14:00Z", "updated_at": "2020-03-24T18:14:00Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" } }, { "id": "9UglUjOXQ13-hMFypCft", "is_owner": false, "status": "ACTIVE", "given_name": "Ashley", "family_name": "Simpson", "email_address": "[email protected]", "phone_number": "+14155552671", "created_at": "2020-03-24T18:14:00Z", "updated_at": "2020-03-24T18:18:00Z", "assigned_locations": { "assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS" }, "wage_setting": { "team_member_id": "9UglUjOXQ13-hMFypCft", "job_assignments": [ { "job_title": "Cashier", "job_id": "VDNpRv8da51NU8qZFC5zDWpF", "pay_type": "HOURLY", "hourly_rate": { "amount": 2000, "currency": "USD" } } ], "is_overtime_exempt": true, "version": 1, "created_at": "2020-03-24T18:14:00Z", "updated_at": "2020-03-24T18:14:03Z" } } ], "cursor": "N:9UglUjOXQ13-hMFypCft" }