Get a Customer
Returns detailed information for a specific customer.
GET https://api.platica.mx/v1/clients/{id}URL parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
id | string | Either the customer ID or their phone number in E.164 format without + | ✓ |
Response
{
"workspaces": [
{
"id": "g6yCA16pkWl5eXo7KszB",
"name": "ws_1",
"clients": [
{
"id": "274fc73cb7d84a17955914fdc1a1f9d0",
"phoneNumber": "524491255844",
"name": "Juan Pérez",
"firstname": "Juan",
"lastname": "Pérez",
"email": "juan.perez@email.com",
"birthdate": null,
"gender": "male",
"company": null,
"country": "MX",
"state": "Jalisco",
"city": "Guadalajara",
"address": null,
"postalCode": null,
"status": "active",
"moderation": {
"totalStrikes": 0,
"lastAction": null,
"lastSource": null,
"lastSeverity": null,
"lastFlaggedAt": null,
"lastCategories": [],
"lastMatchedTerms": [],
"blockedAt": null,
"blockedBy": null,
"blockedReason": null
},
"tags": [],
"owners": ["user1@company.com", "user2@company.com"],
"customFields": {
"placas": "ABC123",
"id_recepcion": "REC001",
"fecha_siniestro": "2025-02-01"
},
"creationDate": "2025-02-06T16:45:50.146Z",
"lastUpdate": "2025-02-06T16:45:50.146Z"
}
],
"clientsCount": 1
}
]
}Response fields
| Field | Description |
|---|---|
id | Internal customer ID |
phoneNumber | Customer phone number without the + prefix |
name | Customer full name |
firstname | Customer first name |
lastname | Customer last name |
email | Email address |
birthdate | Date of birth |
gender | Gender |
company | Company name |
country | Country of residence |
state | State of residence |
city | City of residence |
address | Full address |
postalCode | Postal code |
status | Customer status: active or blocked |
moderation | Moderation history — see below |
tags | Tags associated with the customer |
owners | List of responsible-user emails |
customFields | Customer custom fields |
creationDate | Creation date in ISO 8601 format |
lastUpdate | Last update date in ISO 8601 format |
The moderation object
Always returned in full: a customer with no incidents reports totalStrikes: 0 and every other field as null or empty.
| Field | Description |
|---|---|
totalStrikes | Moderation strikes the customer has accumulated |
lastAction | Action taken on the last offence: warn, assist, or spam |
lastSource | What detected it: lexicon, openai, llm_guardrail, or supervisor |
lastSeverity | Severity of the last offence: low, medium, or high |
lastFlaggedAt | When the last offence was recorded, in ISO 8601 |
lastCategories | Categories reported by the moderator |
lastMatchedTerms | Terms that triggered the detection |
blockedAt | When the customer was blocked, in ISO 8601. null while active |
blockedBy | Who blocked them. null when the block was automatic |
blockedReason | Why they were blocked: guardrails_threshold_reached, manual_dashboard, conversation_spam, api_request, or the free-form reason you sent when blocking them |