Clients
Get client contact
Retrieve a single client contact by its ID.
GET /teams/{teamId}/clients/{clientId}/contacts/{contactId}
Returns a single contact object.
Authentication: Bearer token · Permission:
clients:read · Team permission:client_contacts.read · Rate limit: default (120 / 60s)The key holder's role must include View client contacts. Every standard role includes it. See the permissions matrix.
Path parameters
teamId
string · uuid v7 required
The team the client belongs to.
clientId
string · uuid v7 required
The ID of the contact's client.
contactId
string · uuid v7 required
The ID of the contact to retrieve, from list client contacts.
Query parameters
outputFields
string
Optional. The fields to keep, comma-separated, for example
firstName,email. id is always kept. Use a dot to keep one key of a nested object, for example client.name. Without outputFields, every field is returned.Request
curl https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/clients/0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/contacts/0190f8d2-6b7c-7d8e-9f0a-1b2c3d4e5f6a \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
Returns the full contact object.
{
"success": true,
"data": {
"id": "0190f8d2-6b7c-7d8e-9f0a-1b2c3d4e5f6a",
"clientId": "0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"client": {
"id": "0190f8c0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
"name": "Acme Corp",
"logoUrl": "https://assets.gox.ai/tmr/logos/acme.png"
},
"firstName": "Sarah",
"lastName": "Chen",
"email": "[email protected]",
"jobTitle": "Marketing Director",
"note": "Wants the monthly report before the board meeting.",
"briefingCount": 2,
"createdAt": "2026-10-02T09:30:00.000Z",
"updatedAt": "2026-10-08T14:05:00.000Z",
"createdBy": {
"id": "0190f8b7-3c4d-7e5f-9a0b-1c2d3e4f5a6b",
"name": "Priya Raman",
"firstName": "Priya",
"lastName": "Raman",
"avatarUrl": null,
"email": "[email protected]"
},
"updatedBy": {
"id": "0190f8b8-4d5e-7f6a-8b1c-2d3e4f5a6b7c",
"name": "Arun Menon",
"firstName": "Arun",
"lastName": "Menon",
"avatarUrl": null,
"email": "[email protected]"
}
}
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Invalid UUID: \"abc\"" }
}
The API key does not have the clients:read scope.
{
"success": false,
"error": { "code": "INSUFFICIENT_PERMISSIONS", "message": "This API key is missing the `clients:read` permission required for this endpoint. Grant it to the key under Settings → API Keys (https://hub.twominutereports.com/settings?tab=user-api-keys), or use a key that has it." }
}
Returned when the contact does not exist, belongs to a different client, or belongs to a different team. The API does not tell these cases apart.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Contact not found" }
}