> ## Documentation Index > Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Teams > Search and list Team records with filtering, sorting, and pagination. ## Authentication This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header. The authenticated user must be a full unrestricted administrator or have the **`Team-List`** role. ## Query Parameters ### Pagination & Sorting The page number to retrieve. The number of records per page. The property name to sort results by (e.g. `Name`, `CreatedOn`). Sort direction. `0` for ascending, `1` for descending. ### Filters Filter by Business Id. Filter by business name. Filter by team name. Filter by team description. Filter by tunnel private group ID. Filter by create a single invoice for the team. Filter by use special prices. Filter by Paying Member Id. Filter by paying member full name. Filter by paying member coworker type. Filter by paying member billing name. Filter by paying member company name. Filter by Default Member Tariff Id. Filter by default member tariff name. Filter by maximum team member count. Filter by transfer credits to paying member. Filter by share time passes. Filter by share extra services. Filter by share booking credit. Filter by discount for extra services. Filter by discount for time passes. Filter by discount for charges. Filter by discount for tariffs. Filter by profile summary. Filter by profile tags. Filter by profile website. Filter by google Maps link. Filter by whether the profile is public. Filter by whether the team has a community group. Filter by Team Logo File Name. Filter by New Team Logo Url. Filter by Clear Team Logo File. Filter by Team Image1File Name. Filter by New Team Image1Url. Filter by Clear Team Image1File. Filter by Team Image2File Name. Filter by New Team Image2Url. Filter by Clear Team Image2File. Filter by Team Image3File Name. Filter by New Team Image3Url. Filter by Clear Team Image3File. Filter by twitter handle. Filter by facebook URL. Filter by linkedIn URL. Filter by skype handle. Filter by telegram handle. Filter by gitHub URL. Filter by pinterest URL. Filter by flickr URL. Filter by instagram URL. Filter by vimeo URL. Filter by tumblr URL. Filter by blogger URL. Filter by coworker IDs. Filter by coworker full names. Filter by coworker billing names. Filter by number of active contracts. Filter by average churn probability. Filter by engagement level. Filter by disable attendance dashboard. ### Range Filters Filter by maximum team member count greater than or equal to this value. Filter by maximum team member count less than or equal to this value. Filter by discount for extra services greater than or equal to this value. Filter by discount for extra services less than or equal to this value. Filter by discount for time passes greater than or equal to this value. Filter by discount for time passes less than or equal to this value. Filter by discount for charges greater than or equal to this value. Filter by discount for charges less than or equal to this value. Filter by discount for tariffs greater than or equal to this value. Filter by discount for tariffs less than or equal to this value. Filter by number of active contracts greater than or equal to this value. Filter by number of active contracts less than or equal to this value. Filter by average churn probability greater than or equal to this value. Filter by average churn probability less than or equal to this value. Filter records created on or after this date. Format: `YYYY-MM-DDTHH:mm`. Filter records created on or before this date. Format: `YYYY-MM-DDTHH:mm`. Filter records updated on or after this date. Format: `YYYY-MM-DDTHH:mm`. Filter records updated on or before this date. Format: `YYYY-MM-DDTHH:mm`. ## Code Examples ### Simple listing ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/teams?page=1&size=15&orderBy=Name&dir=0" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/teams?' + new URLSearchParams({ page: 1, size: 15, orderBy: 'Name', dir: 1 // Ascending }), { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/teams', params={ 'page': 1, 'size': 15, 'orderBy': 'Name', 'dir': 0 // Ascending }, headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) data = response.json() ``` ### Filtering by Name ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/teams?Team_Name=example-value&orderBy=Name&dir=0" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/teams?' + new URLSearchParams({ Team_Name: 'example-value', orderBy: 'Name', dir: 1 }), { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/teams', params={ 'Team_Name': 'example-value', 'orderBy': 'Name', 'dir': 0 // Ascending }, headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) data = response.json() ``` ### Range filters ```bash cURL theme={null} curl -X GET \ "https://spaces.nexudus.com/api/spaces/teams?from_Team_UpdatedOn=2025-01-01T00:00&to_Team_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=0" \ -H "Authorization: Bearer YOUR_TOKEN" ``` ```javascript JavaScript theme={null} const response = await fetch( 'https://spaces.nexudus.com/api/spaces/teams?' + new URLSearchParams({ from_Team_UpdatedOn: '2025-01-01T00:00', to_Team_UpdatedOn: '2025-12-31T23:59', orderBy: 'UpdatedOn', dir: 1 // Descending }), { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } } ); const data = await response.json(); ``` ```python Python theme={null} import requests response = requests.get( 'https://spaces.nexudus.com/api/spaces/teams', params={ 'from_Team_UpdatedOn': '2025-01-01T00:00', 'to_Team_UpdatedOn': '2025-12-31T23:59', 'orderBy': 'UpdatedOn', 'dir': 1 // Descending }, headers={ 'Authorization': 'Bearer YOUR_TOKEN' } ) data = response.json() ``` ## Response ### 200 The list of Team records matching the query. See the [Get one Team](/rest-api/spaces/get-teams-by-id) endpoint for the full list of properties returned for each record. **Partial records** — The listing endpoint returns a summary representation of each Team. The following fields are **not populated** in the `Records[]` response: `Description`, `UseSpecialPrices`, `MaxTeamMemberCount`, `TransferCreditsToPayingMember`, `ShareTimePasses`, `ShareExtraServices`, `ShareBookingCredit`, `DiscountExtraServices`, `DiscountTimePasses`, `DiscountCharges`, `DiscountTariffs`, `ProfileSummary`, `ProfileTags`, `ProfileWebsite`, `GoogleMapsLink`, `Twitter`, `Facebook`, `Linkedin`, `Skype`, `Telegram`, `Github`, `Pinterest`, `Flickr`, `Instagram`, `Vimeo`, `Tumblr`, `Blogger`, `DisableAttendanceDashboard`. To get all fields, fetch the full record using the [Get one Team](/rest-api/spaces/get-teams-by-id) endpoint. **Important for updates:** When updating a record via `PUT`, always retrieve the full record with a `GET` request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a `PUT` request, as missing fields may be unintentionally cleared. Current page number. Number of records per page. The field used for sorting. The sort direction (`0` = ascending, `1` = descending). Index of the first item on the current page. Index of the last item on the current page. Total number of matching records across all pages. Total number of pages. Whether there is a next page of results. Whether there is a previous page of results. ```json Example Response theme={null} { "Records": [ { "BusinessId": 0, "BusinessName": null, "Name": "", "TunnelPrivateGroupId": null, "TeamMembers": [], "TeamAdministrators": [], "CreateSingleInvoiceForTeam": false, "PayingMemberId": null, "PayingMemberFullName": null, "PayingMemberCoworkerType": null, "PayingMemberBillingName": null, "PayingMemberCompanyName": null, "DefaultMemberTariffId": null, "DefaultMemberTariffName": null, "ProfileIsPublic": false, "HasCommunityGroup": false, "TeamLogoFileName": null, "NewTeamLogoUrl": null, "ClearTeamLogoFile": null, "TeamImage1FileName": null, "NewTeamImage1Url": null, "ClearTeamImage1File": null, "TeamImage2FileName": null, "NewTeamImage2Url": null, "ClearTeamImage2File": null, "TeamImage3FileName": null, "NewTeamImage3Url": null, "ClearTeamImage3File": null, "CoworkerIds": null, "CoworkerFullNames": null, "CoworkerBillingNames": null, "ActiveContracts": 0, "AvgChurnProbability": null, "EngagementLevel": null, "ExtraServices": [], "Id": 87654321, "UpdatedOn": "2025-01-15T10:30:00Z", "CreatedOn": "2025-01-10T08:00:00Z", "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "UpdatedBy": "admin@example.com", "IsNew": false, "SystemId": null, "ToStringText": "Team Example", "LocalizationDetails": null, "CustomFields": null } ], "CurrentPageSize": 15, "CurrentPage": 1, "CurrentOrderField": "Name", "CurrentSortDirection": 1, "FirstItem": 1, "HasNextPage": false, "HasPreviousPage": false, "LastItem": 1, "PageNumber": 1, "PageSize": 15, "TotalItems": 1, "TotalPages": 1 } ```