Skip to main content
GET
/
contacts
/
{contact_id}
Get Contact
curl --request GET \
  --url https://api.clemta.com/contacts/{contact_id}
{
  "success": true,
  "message": "<string>",
  "data": {
    "id": "<string>",
    "created_at": 123,
    "updated_at": 123,
    "type": "<string>",
    "status": "<string>",
    "full_name": "<string>",
    "email": "<string>",
    "description": "<string>",
    "cc_emails": [
      {}
    ],
    "bcc_emails": [
      {}
    ],
    "billing": {
      "email": "<string>",
      "phone": "<string>",
      "phone_code": "<string>",
      "iso_code": "<string>",
      "country": "<string>",
      "address_1": "<string>",
      "address_2": "<string>",
      "postal_code": "<string>",
      "district": "<string>",
      "state": "<string>",
      "province": "<string>",
      "tax_id": "<string>"
    }
  }
}

​
Authentication

This endpoint requires authentication using an API key. Include your API key in the request header: 
X-API-Key: your_api_key_here
See Authentication for more details.

​
Path Parameters

​
contact_id
string
required
The unique identifier of the contact to retrieve.

​
Response

​
success
boolean
Indicates if the request was successful.
​
message
string
Response message.
​
data
object
The contact object.

​
HTTP Response Codes

CodeDescription
200Contact retrieved successfully
400Invalid request
401Unauthorized - Invalid or missing API key
404Contact not found
500Internal server error

​
Error Response

When an error occurs, the API returns an error response: 
{
  "success": false,
  "message": "Contact not found",
  "data": null,
  "error": {
    "code": "NOT_FOUND",
    "details": ""
  }
}

​
Code Examples

curl -X GET https://api.clemta.com/contacts/64b8f1a2e4b0c8d9f0123456 \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "success": true,
  "message": "Contact retrieved successfully",
  "data": {
    "id": "64b8f1a2e4b0c8d9f0123456",
    "created_at": 1640995200,
    "updated_at": 1640995200,
    "type": "customer",
    "status": "active",
    "full_name": "John Doe",
    "email": "[email protected]",
    "description": "Primary contact for the company",
    "cc_emails": ["[email protected]", "[email protected]"],
    "bcc_emails": ["[email protected]"],
    "billing": {
      "email": "[email protected]",
      "phone": "1234567890",
      "phone_code": "+1",
      "iso_code": "US",
      "country": "United States",
      "address_1": "123 Main Street",
      "address_2": "Suite 100",
      "postal_code": "12345",
      "district": "Downtown",
      "state": "CA",
      "province": "California",
      "tax_id": "12-3456789"
    }
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us