Get Customer

Request

GET /v2/customers/100 HTTP/1.1
Authorization: Bearer oauth_token

Path Parameters

/v2/customers/{customerId}

Response

HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8

{
  "id" : 500,
  "firstName" : "Vernon",
  "lastName" : "Bear",
  "gender" : "Male",
  "jobTitle" : "CEO and Co-Founder",
  "location" : "Greater Dallas/FT Worth Area",
  "organization" : "Acme, Inc",
  "photoType" : "twitter",
  "photoUrl" : "http://twitter.com/img/some-avatar.jpg",
  "age" : "30-35",
  "createdAt" : "2012-07-23T12:34:12Z",
  "updatedAt" : "2012-07-24T20:18:33Z",
  "background" : "I've worked with Vernon before and he's really great.",
  "_embedded" : {
    "emails" : [ ],
    "websites" : [ ],
    "chats" : [ ],
    "phones" : [ ],
    "social_profiles" : [ ]
  },
  "_links" : {
    "address" : {
      "href" : "..."
    },
    "chats" : {
      "href" : "..."
    },
    "emails" : {
      "href" : "..."
    },
    "phones" : {
      "href" : "..."
    },
    "self" : {
      "href" : "..."
    },
    "social-profiles" : {
      "href" : "..."
    },
    "websites" : {
      "href" : "..."
    }
  }
}

Response fields

Path Type Description
firstName String First name of the customer. When defined it must be between 1 and 40 characters.
lastName String Last name of the customer. When defined it must be between 1 and 40 characters.
phone String Optional phone number that will be used when creating a new customer
photoUrl String URL of the customer’s photo
jobTitle String Job title
photoType String Type of photo. Accepted values are:
unknown
gravatar
twitter
facebook
googleprofile
googleplus
linkedin
background String This is the Notes field from the user interface.
location String Location of the customer
organization String Organization
gender String Gender of this customer. Accepted values are:
male
female
unknown
age String Customer’s age
id Number Unique identifier
createdAt String Time and date when the customer was created (UTC)
updatedAt String Time and date when the customer was update (UTC)
_embedded Object Container for embedded customer sub entities
Relation Description
address Customer’s address
chats Customer’s chat handles
emails Customer’s emails
phones Customer’s phones
social-profiles Customer’s social profiles
websites Customer’s websites