Read (GET) Contact

Use this API to read a single contact from the Contacts hub.

To read a contact:

Execute a GET command on the endpoint {{url}}/contact/<ID>, where ID is the ID of the contact you want to read.

For example, here is a request, using cURL, to get contact ID ADMIN1013718587810.

curl --request GET \
  --url 'https://{{url}}/contact/ADMIN1013718587810' \
  --header 'authorization: Bearer {{oauth_token}}' \
  --header 'content-type: application/json'

The call returns the JSON representation of the contact, for example:

[
    {
        "Company": "Madison Company",
        "flName": "Al Balfour",
        "ContactID": "AEM45",
        "ClientID": "AEM45",
        "CLAddress": "Default",
        "Vendor": "",
        "VEAddress": "",
        "LastName": "Balfour",
        "FirstName": "Albertia",
        "MiddleName": "",
        "Salutation": "Mr.",
        "Suffix": "",
        "Title": "Chief Executive Officer",
        "Address1": "",
        "Address2": "",
        "Address3": "",
        "Address4": "",
        "City": "",
        "State": "",
        "Zip": "",
        "Country": "",
        "Phone": "202.555.8300",
        "Fax": "202.555.8301",
        "Pager": "",
        "CellPhone": "",
        "HomePhone": "",
        "Email": "email@company.com",
        "Memo": "",
        "MailingAddress": "N",
        "Billing": "N",
        "PrimaryInd": "N",
        "ContactStatus": "A",
        "CreateUser": "William Apple, PE",
        "CreateDate": "2005-09-04T17:44:57.000",
        "ModUser": "William Apple, PE",
        "ModDate": "2017-01-18T22:16:16.580",
        "Addressee": "",
        "PreferredName": "Al",
        "CustomCurrencyCode": " ",
        "Source": "",
        "PagerFormat": "",
        "CellPhoneFormat": "",
        "HomePhoneFormat": "",
        "AjeraSync": "",
        "TLInternalKey": "",
        "TLSyncModDate": "",
        "Owner": "",
        "StatusReason": "",
        "Rating": "",
        "FirmDescription": "",
        "FirmAddress1": "5312 7th Avenue",
        "FirmAddress2": "",
        "FirmAddress3": "",
        "FirmAddress4": "",
        "FirmCity": "Washington",
        "FirmState": "DC",
        "FirmZip": "24001",
        "FirmCountry": "US",
        "FirmBusinessPhone": "202.555.8300",
        "FirmBusinessPhoneFormat": "",
        "FirmBusinessFax": "202.555.8301",
        "FirmBusinessFaxFormat": "",
        "FirmPager": "",
        "Market": "",
        "Website": "",
        "QualifiedStatus": "sysQual",
        "StatusDate": "2017-04-18T18:12:22.440",
        "ProfessionalSuffix": "",
        "SFID": "",
        "emOwnerfl": "",
        "TopTPStartDate": "2005-09-04T13:30:04.663",
        "TopTPSubject": " ",
        "TopTPContactID": "AEM45",
        "TopTPCreateEmployee": "00001",
        "TopTPCreateUserName": "ADMIN",
        "HasPhoto": 0,
        "PhotoModDate": "",
        "ClientName": "Madison Company",
        "VName": "",
        "QBOID": "",
        "QBOIsMainContact": "N",
        "QBOLastUpdated": "",
        "custBirthDate": "",
        "custNewsletter": "y",
        "custCorporateList": "N",
        "custSpouseName": "",
        "custGolf": "N",
        "custPromotional": "N",
        "custMarket": "",
        "custPersonal": ""
    }
]