Clients / Index

NameClients / Index
DescriptionList Clients that belong to your Brokerage.
TypeGET
URL/v9/clients
Credential TypeAPI|User
Supports PaginationYes

Long Description

List Clients that belong to your Brokerage.

Parameters

Name
Description
Type
Presence
LocationConditionals
office_idList only Clients who belong to a specific office within your brokerageIntegerOptionalQueryNo
company_idList Clients that belong to a companyIntegerOptionalQueryNo
nameExact match of Client nameStringOptionalQueryNo
created_atCreation timestampDate (ISO_8601)OptionalQueryYes
updated_atLast updated timestampDate (ISO_8601)OptionalQueryYes

 

Examples

RequestResponse
/v9/clients
{
  "current_page":1,
  "total_entries":2,
  "clients":[
    {
      "primary_credit_card":null,
      "primary_email_address":null,
      "company":null,
      "phone_numbers":[
        {
          "extension":null,
          "country_code":null,
          "label":"Office",
          "number":"(615) 555-5555",
          "id":"130002"
        }
      ],
      "email_addresses":[

      ],
      "url":"/clients/84334",
      "primary_shipping_address":null,
      "balance":"0.0",
      "updated_at":"2013-02-01T02:05:15Z",
      "tags":[

      ],
      "primary_billing_address":null,
      "name":"Bridgestone Arena",
      "notes":null,
      "id":"84334",
      "addresses":[
        {
          "locality":"Nashville",
          "postal_code":"37203",
          "country_code":"US",
          "street_address":"333 Some Ave",
          "label":"Office",
          "primary":false,
          "latitude":null,
          "extended_address":null,
          "po_box":false,
          "name":null,
          "id":"372965",
          "longitude":null,
          "region":"TN"
        }
      ],
      "primary_phone_number":null
    },
    {
      "primary_credit_card":null,
      "primary_email_address":null,
      "company":null,
      "phone_numbers":[
        {
          "extension":null,
          "country_code":null,
          "label":"Office",
          "number":"(201) 555-5555",
          "id":"130001"
        }
      ],
      "email_addresses":[

      ],
      "url":"/clients/84333",
      "primary_shipping_address":null,
      "balance":"0.0",
      "updated_at":"2013-02-01T02:03:10Z",
      "tags":[

      ],
      "primary_billing_address":null,
      "name":"John Client",
      "notes":null,
      "id":"84333",
      "addresses":[
        {
          "locality":"Jersey City",
          "postal_code":"07302",
          "country_code":"US",
          "street_address":"444 Other Ave",
          "label":"Office",
          "primary":false,
          "latitude":null,
          "extended_address":null,
          "po_box":false,
          "name":null,
          "id":"372964",
          "longitude":null,
          "region":"NJ"
        }
      ],
      "primary_phone_number":null
    }
  ]
}