List the labels for one kind of list entry
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Labels are a special type of keyword that give context to Social Profiles, E-mail Address, URLs, Phone Numbers, and Addresses.
Labels are usually a broad classification for the object that they are labeling. For example, common labels for phone numbers are "Home", "Mobile", and "Work". Common labels for URLs might be "Homepage", "Blog", or "Support".
A label can be any short string (max 32 characters) that gives context to the entry it is labeling. Every entry needs a label. When you create or update a contact or company with a label name that does not exist yet, the label is created automatically.
You can get a list of all known labels for a particular kind of entry, sorted by name, using the various label endpoints:
| Label Name | Label Type | Endpoint | Example Response |
|---|---|---|---|
| Social Profile | social_profiles | /v1/labels/social_profiles | ["Home", "Personal"] |
| emails | /v1/labels/emails | ["Work", "Personal"] | |
| URL | urls | /v1/labels/urls | ["Homepage", "Blog"] |
| Phone Number | phone_numbers | /v1/labels/phone_numbers | ["Home", "Mobile"] |
| Address | addresses | /v1/labels/addresses | ["Home", "Office"] |