Read (GET) Categories Associated with a Contact

Use this API to read all categories associated with a contact in the Contacts hub. Use this endpoint to retrieve categories that apply to the contact. A contact may have many applied categories. The categories are useful for grouping contacts together based on something that they have in common, which then allows you to search for contacts with specific characteristics.

To get all categories associated with the specified contact:

Execute a GET command on the endpoint {{url}}/contact/{{ContactID}}/category

For example, using cURL to submit the GET request, here is an example of how to get all categories associated with a contact:

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

The call returns one JSON structure like the following for each category associated with the specified contact in the Contacts hub. Double quotes in the returned JSON indicate that the field has no data.

{
        "ContactID": "TESTTESTI1234567890123",
        "Category": "e-Newsletter",
        "CategoryDesc": "e-Newsletter",
        "Info": "e-Newsletter additional information",
        "CreateUser": "LoggedInUserWhoCreatedtheEntry",
        "CreateDate": "2017-12-08T17:31:10.000",
        "ModUser": "LoggedInUserWhoChangedtheEntry",
        "ModDate": "2017-12-09T19:07:26.493"
    }