REST API: List Managed Clients

Last Updated: August 17, 2016

Description

Retrieves a list of managed clients available from your account. To use this endpoint you must be an admin on your account and have the External Access add-on installed.

Resource Information

HTTP Method GET
Endpoint https://rest.tsheets.com/api/v1/managed_clients
Authentication Token header required. See authentication section.
Request format Everything is handled through the request URI on a GET.
Response format json
Response object Managed Client

Available Filters

active:
optional
String. 'yes', 'no', or 'both'. Default is 'yes'.
per_page:
optional
Integer. Represents how many results you'd like to retrieve per request (page). Default is 50. Max is 50.
page:
optional
Integer. Represents the page of results you'd like to retrieve. Default is 1.

Examples

Retrieve a list of all managed clients under your account.

## REQUEST
curl -H "Authorization: Bearer <Access-Token>" -i "https://rest.tsheets.com/api/v1/managed_clients"

## RESPONSE (shortened for readability)
HTTP/1.1 200 OK
Content-Type: application/json

{  
   "results":{  
      "managed_clients":{  
         "1146":{  
            "id":"1146",
            "company_url":"acmedev",
            "company_name":"Acme Dev",
            "active":true,
            "created":"2016-05-31T16:52:50+00:00",
            "last_modified":"2016-08-08T22:23:34+00:00"
         },
         "1232":{  
            "id":"1232",
            "company_url":"acmetrucking",
            "company_name":"Acme Trucking",
            "active":true,
            "created":"2016-07-13T20:14:52+00:00",
            "last_modified":"2016-07-13T20:19:12+00:00"
         },
         "1274":{  
            "id":"1274",
            "company_url":"bodacious",
            "company_name":"Bodacious Swine",
            "active":false,
            "created":"2016-08-09T17:21:28+00:00",
            "last_modified":"2016-08-09T17:22:44+00:00"
         },
         "1233":{  
            "id":"1233",
            "company_url":"acmeclean",
            "company_name":"Acme Cleaning",
            "active":false,
            "created":"2016-07-13T20:32:46+00:00",
            "last_modified":"2016-07-13T20:35:06+00:00"
         }
      },
      "more":false
   }
}