List Clients

GET https://api.freshbooks.com/accounting/account/{{accountId}}/users/clients

list all clients

Request Params

KeyDatatypeRequiredDescription
include[]stringclient's outstanding balance
include[]stringclient's current balance of credit
include[]stringbalance of draft invoices for client
include[]stringoverdue balance for client
include[]stringgrand total for client
include[]stringinformation about late fees
include[]stringinformation about late reminders
include[]stringlast activity time

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"response":{"result":{"clients":[{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"api.freshbooks@gmail.com","fax":"","fname":"Nicholas","has_retainer":null,"home_phone":null,"id":92402,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Jaar","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Space Is Only Noise","p_city":"Toronto","p_code":"M6P 3T1","p_country":"","p_province":"Ontario","p_street":"1655 Dupont St. W.","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-05-08 19:25:29","statement_token":null,"subdomain":null,"updated":"2019-05-08 15:25:29","userid":92402,"username":"nicholasjaar2","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"api.freshbooks@gmail.com","fax":"","fname":"Ryan","has_retainer":null,"home_phone":null,"id":75162,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Marr","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Ryan Marr","p_city":"","p_code":"","p_country":"","p_province":"","p_street":"","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-05-02 14:31:30","statement_token":null,"subdomain":null,"updated":"2019-05-02 13:00:27","userid":75162,"username":"ryanmarr","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"api.freshbooks+1@gmail.com","fax":"","fname":"Nicholas","has_retainer":null,"home_phone":null,"id":46834,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Jaar","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Space Is Only Noise","p_city":"Toronto","p_code":"M6P 3T1","p_country":"","p_province":"Ontario","p_street":"1655 Dupont St. W.","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-24 17:45:17","statement_token":null,"subdomain":null,"updated":"2019-04-26 13:52:56","userid":46834,"username":"nicholasjaar","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"api.freshbooks@gmail.com","fax":"","fname":"Elbert","has_retainer":null,"home_phone":"804-177-0551","id":32082,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Vatcher","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Blick, Dickinson and Morar","p_city":"Richmond","p_code":"","p_country":"United States","p_province":"Virginia","p_street":"9 Park Meadow Street","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:32","statement_token":null,"subdomain":null,"updated":"2019-04-22 10:37:33","userid":32082,"username":"elbertvatcher","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"mwesthofer5i@imdb.com","fax":"","fname":"Myrta","has_retainer":null,"home_phone":"832-780-4312","id":32080,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Westhofer","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Prosacco Group","p_city":"Houston","p_code":"","p_country":"United States","p_province":"Texas","p_street":"70347 Ramsey Plaza","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:32","statement_token":null,"subdomain":null,"updated":"2019-05-03 03:45:42","userid":32080,"username":"myrtawesthofer","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"bmichelin5h@github.io","fax":"","fname":"Beaufort","has_retainer":null,"home_phone":"408-201-8841","id":32078,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Michelin","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Witting, McDermott and Gutmann","p_city":"San Jose","p_code":"","p_country":"United States","p_province":"California","p_street":"5 Kings Pass","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:32","statement_token":null,"subdomain":null,"updated":"2019-04-22 10:43:38","userid":32078,"username":"beaufortmichelin","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"tarblaster5g@vk.com","fax":"","fname":"Tarra","has_retainer":null,"home_phone":"254-975-2685","id":32076,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Arblaster","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Hermann-Jast","p_city":"Waco","p_code":"","p_country":"United States","p_province":"Texas","p_street":"05 Haas Trail","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:31","statement_token":null,"subdomain":null,"updated":"2019-04-22 10:49:56","userid":32076,"username":"tarraarblaster","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"ranfosso5f@toplist.cz","fax":"","fname":"Roger","has_retainer":null,"home_phone":"713-881-3522","id":32074,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Anfosso","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Kuhn, Ondricka and Reilly","p_city":"Houston","p_code":"","p_country":"United States","p_province":"Texas","p_street":"01496 Novick Court","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:31","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:31","userid":32074,"username":"rogeranfosso","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"agoodlad5e@redcross.org","fax":"","fname":"Ariella","has_retainer":null,"home_phone":"718-429-4271","id":32072,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Goodlad","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Schneider-Hoeger","p_city":"Bronx","p_code":"","p_country":"United States","p_province":"New York","p_street":"77 Melody Hill","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:31","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:31","userid":32072,"username":"ariellagoodlad","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"bscardifield5d@yellowbook.com","fax":"","fname":"Brooke","has_retainer":null,"home_phone":"913-353-2546","id":32070,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Scardifield","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"McClure-Dibbert","p_city":"Kansas City","p_code":"","p_country":"United States","p_province":"Kansas","p_street":"6911 Pankratz Plaza","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:31","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:31","userid":32070,"username":"brookescardifield","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"egelardi5c@bloglovin.com","fax":"","fname":"Evangeline","has_retainer":null,"home_phone":"213-187-2288","id":32068,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Gelardi","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Heaney and Sons","p_city":"Los Angeles","p_code":"","p_country":"United States","p_province":"California","p_street":"02 Glendale Lane","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:31","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:31","userid":32068,"username":"evangelinegelardi","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"acraythorne5b@constantcontact.com","fax":"","fname":"Audry","has_retainer":null,"home_phone":"608-624-6164","id":32066,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Craythorne","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Kunze-Kunze","p_city":"Madison","p_code":"","p_country":"United States","p_province":"Wisconsin","p_street":"8138 Buena Vista Hill","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:31","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:31","userid":32066,"username":"audrycraythorne","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"cdaviot5a@newyorker.com","fax":"","fname":"Crissy","has_retainer":null,"home_phone":"574-571-1318","id":32064,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Daviot","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Langosh-Fritsch","p_city":"South Bend","p_code":"","p_country":"United States","p_province":"Indiana","p_street":"0550 Loomis Terrace","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:30","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:31","userid":32064,"username":"crissydaviot","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"imuddimer59@instagram.com","fax":"","fname":"Iorgo","has_retainer":null,"home_phone":"573-831-6641","id":32062,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Muddimer","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Borer-Welch","p_city":"Columbia","p_code":"","p_country":"United States","p_province":"Missouri","p_street":"10109 Alpine Terrace","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:30","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:30","userid":32062,"username":"iorgomuddimer","vat_name":null,"vat_number":null,"vis_state":0},{"accounting_systemid":"wkMd2g","allow_late_fees":true,"allow_late_notifications":true,"bus_phone":"","company_industry":null,"company_size":null,"currency_code":"USD","direct_link_token":null,"email":"mjolley58@moonfruit.com","fax":"","fname":"Maryanna","has_retainer":null,"home_phone":"626-885-3822","id":32060,"language":"en","last_activity":null,"last_login":null,"level":0,"lname":"Jolley","mob_phone":"","note":null,"notified":false,"num_logins":0,"organization":"Haley, Renner and Vandervort","p_city":"Pasadena","p_code":"","p_country":"United States","p_province":"California","p_street":"7 Bartelt Plaza","p_street2":"","pref_email":true,"pref_gmail":false,"retainer_id":null,"role":"client","s_city":"","s_code":"","s_country":"","s_province":"","s_street":"","s_street2":"","signup_date":"2019-04-18 18:28:30","statement_token":null,"subdomain":null,"updated":"2019-04-18 14:28:30","userid":32060,"username":"maryannajolley","vat_name":null,"vat_number":null,"vis_state":0}],"page":1,"pages":14,"per_page":15,"total":205}}}