mndrAPI Docs
Contacts

Get Contact

Retrieve a contact by ID or email.

GET /api/v1/contacts/:id

Retrieve a contact by its ID.

Request
curl /api/v1/contacts/uuid-here \
  -H "x-api-key: mndr_..."
Response (200)
{
  "contact": {
    "id": "uuid",
    "email": "jane@example.com",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": null,
    "tags": ["customer"],
    "customFields": { "plan": "pro" },
    "emailSubscriptionStatus": "subscribed",
    "whatsappSubscriptionStatus": "subscribed",
    "createdAt": "2026-03-23T12:00:00.000Z",
    "updatedAt": "2026-03-23T12:00:00.000Z"
  }
}

GET /api/v1/contacts/by-email/:email

Retrieve a contact by email address. Useful when you don't have the contact ID.

Request
curl /api/v1/contacts/by-email/jane@example.com \
  -H "x-api-key: mndr_..."

Returns the same response shape as get-by-ID. Returns 404 if no contact with that email exists.

On this page