Get Contact's Tags
Return the list of tag links associated with a contact. Each item includes the linking record ID, tag ID, and tag metadata.
GET
/v2/contacts/tags
Query Parameters
id uuid
Required
The contact ID whose tags you want to retrieve.
cURl example
curl -X GET 'https://lunarsend.com/api/v2/contacts/tags?id=40de0a85-b09f-41a5-9935-c2746a8f10bb' \
-H 'x-api-key: $LUNARSEND_API_KEY' \
-H 'Accept: application/json'Response
[
{
"status": "success",
"id": "40de0a85-b09f-41a5-9935-c2746a8f10bb",
"data": [
{
"contact_tag_id": "8a37ae54-56f9-4332-a411-d8de79d7d09a",
"tag_id": "00d72111-8510-4ea3-84eb-1e2894060d51",
"tag_name": "VIP",
"color": "#FFC300",
"created_at": "2025-09-21T17:32:42.999165+00:00",
"user_id": "f446e4f9-5110-4a75-92bd-73a4a0c54196",
"contact_id": "40de0a85-b09f-41a5-9935-c2746a8f10bb"
},
{
"contact_tag_id": "44a8e6f0-30e2-4071-9e96-ad6909a950e4",
"tag_id": "a0cb441b-afc6-4b5c-8689-0c4577193f99",
"tag_name": "New Lead",
"color": "#FD7E14",
"created_at": "2025-09-21T17:37:42.098909+00:00",
"user_id": "f446e4f9-5110-4a75-92bd-73a4a0c54196",
"contact_id": "40de0a85-b09f-41a5-9935-c2746a8f10bb"
},
{
"contact_tag_id": "c06b249f-c95e-4009-a69c-386d6e5808fa",
"tag_id": "0eed8fc2-c95a-4d38-a48c-0fbf12e0b224",
"tag_name": "Moving Fast",
"color": "#E83E8C",
"created_at": "2025-09-21T20:15:11.48325+00:00",
"user_id": "f446e4f9-5110-4a75-92bd-73a4a0c54196",
"contact_id": "40de0a85-b09f-41a5-9935-c2746a8f10bb"
}
]
}
]Response Fields
| Field | Type | Status | Format | Notes |
|---|---|---|---|---|
| status | enum successerror | read-only optional | - | - |
| error | string - Error description (only present on error) | read-only optional | - | - |
| id | string (uuid) - Contact ID this result corresponds to | read-only optional | uuid | The contact ID corresponding to this result object. |
| data | object | required | - | - |
| data.contact_tag_id | string (uuid) - Linking row ID | read-only optional | uuid | Primary key of the link row in contact_tags. |
| data.tag_id | string (uuid) - Tag ID | read-only optional | uuid | Primary key of the tag. |
| data.tag_name | string | optional nullable | - | May be null if the tag was soft-deleted or anonymized. |
| data.color | string (hex RGB) | optional nullable | - | Hex color for the tag label (e.g., #FD7E14). |
| data.created_at | string (ISO 8601) - When the link (ct) was created | read-only optional | date-time | Timestamp when the contact→tag link was created. |
| data.user_id | string (uuid) - Tag owner/creator user id | read-only optional nullable | uuid | User who owns/created the tag. |
| data.contact_id | string (uuid) - Redundant contact ID for convenience | read-only optional | uuid | Redundant convenience field for the contact ID. |