Search team members
POST
/v2/team-members/search
Returns a paginated list of TeamMember
objects for a business.
The list to be returned can be filtered by:
- location IDs and
status
Name | Description |
---|---|
query
|
The query parameters. |
limit
|
The maximum number of |
cursor
|
The opaque cursor for fetching the next page. Read about pagination with Square APIs for more information. |
Response Fields
Name | Description |
---|---|
team_
|
The filtered list of |
cursor
|
The opaque cursor for fetching the next page. Read about pagination with Square APIs for more information. |
errors
|
The errors that occurred during the request. |
Examples
POST
/v2/team-members/search
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/team-members/search \
-X POST \
-H 'Square-Version: 2021-01-21' \
-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": "johnny_cash@squareup.com",
"created_at": "2019-07-10T17:26:48Z",
"updated_at": "2020-04-28T21:49:28.957Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
},
{
"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:01.127Z",
"updated_at": "2020-06-09T17:38:05.423Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
},
{
"id": "2JCmiJol_KKFs9z2Evim",
"is_owner": false,
"status": "ACTIVE",
"given_name": "Monica",
"family_name": "Sway",
"created_at": "2020-03-24T01:09:25.010Z",
"updated_at": "2020-03-24T01:09:25.010Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
},
{
"id": "4uXcJQSLtbk3F0UQHFNQ",
"is_owner": false,
"status": "ACTIVE",
"given_name": "Elton",
"family_name": "Ipsum",
"created_at": "2020-03-24T01:09:23.464Z",
"updated_at": "2020-03-24T01:09:23.464Z",
"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:23.074Z",
"updated_at": "2020-03-24T01:09:23.074Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
},
{
"id": "5MRPTTp8MMBLVSmzrGha",
"is_owner": false,
"status": "ACTIVE",
"given_name": "Patrick",
"family_name": "Steward",
"email_address": "patrick_steward@gmail.com",
"phone_number": "+14155552671",
"created_at": "2020-03-24T18:14:03.865Z",
"updated_at": "2020-03-24T18:14:03.865Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
},
{
"id": "7F5ZxsfRnkexhu1PTbfh",
"is_owner": false,
"status": "ACTIVE",
"given_name": "Ivy",
"family_name": "Manny",
"created_at": "2020-03-24T01:09:25.180Z",
"updated_at": "2020-03-24T01:09:25.180Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
},
{
"id": "808X9HR72yKvVaigQXf4",
"is_owner": false,
"status": "ACTIVE",
"given_name": "John",
"family_name": "Smith",
"email_address": "john_smith@gmail.com",
"phone_number": "+14155552671",
"created_at": "2020-03-24T18:14:02.797Z",
"updated_at": "2020-03-24T18:14:02.797Z",
"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": "r_wen@gmail.com",
"phone_number": "+14155552671",
"created_at": "2020-03-24T18:14:00.399Z",
"updated_at": "2020-03-24T18:14:00.399Z",
"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": "asimpson@gmail.com",
"phone_number": "+14155552671",
"created_at": "2020-03-24T18:14:00.445Z",
"updated_at": "2020-03-24T18:14:00.445Z",
"assigned_locations": {
"assignment_type": "ALL_CURRENT_AND_FUTURE_LOCATIONS"
}
}
],
"cursor": "N:9UglUjOXQ13-hMFypCft"
}