Saltar al contenido principal
GET
/
v1
/
contacts
/
{contactId}
/
tags
curl -X GET "https://api.contactship.ai/v1/contacts/c1d2e3f4-a5b6-7890-cdef-123456789012/tags" \
  -H "x-api-key: your-api-key"

[
  {
    "id": "tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "hot-lead",
    "color": "#FF5733",
    "label": "Hot Lead"
  },
  {
    "id": "tag-b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "customer",
    "color": "#33FF57",
    "label": "Customer"
  }
]
Returns all tags currently assigned to a contact.

​
Headers

​
x-api-key
string
requerido
Your API key for authentication. Found in your dashboard under API settings.

​
Path Parameters

​
contactId
string
requerido
The UUID of the contact.

​
Response

Returns an array of tag objects assigned to the contact.
​
id
string
Unique identifier of the tag (UUID).
​
name
string
The tag name.
​
color
string
Hex color code of the tag.
​
label
string
Display label of the tag, if set.

​
Error Codes

  • 401 Unauthorized — Invalid or missing API key
  • 404 Not Found — Contact not found
  • 500 Internal Server Error — Server-side error

​
Code Examples

curl -X GET "https://api.contactship.ai/v1/contacts/c1d2e3f4-a5b6-7890-cdef-123456789012/tags" \
  -H "x-api-key: your-api-key"

[
  {
    "id": "tag-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "hot-lead",
    "color": "#FF5733",
    "label": "Hot Lead"
  },
  {
    "id": "tag-b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "customer",
    "color": "#33FF57",
    "label": "Customer"
  }
]