> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendify.dingstore.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a contact by email

> Get one contact in the current account by email address

Returns the contact that exactly matches an email address in the current account.

```http theme={null}
GET https://api.sendify.dingstore.cn/dmx/v2/contacts/{email}
```

## Authentication

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Path parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `email` | `string` | Yes | Full contact email address. URL-encode it before placing it in the path |

## Request example

```bash theme={null}
curl "https://api.sendify.dingstore.cn/dmx/v2/contacts/person%40example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Success response

The `contact` object contains `firstName`, `lastName`, `company`, `position`, `source`, `createTime`, `customFields`, `lastOpenTime`, `email`, and `tagNames`. `source` is one of `import`, `user_add`, or `open_api`.

## Error responses

| HTTP status | Meaning |
| - | - |
| `400` | Invalid email format |
| `401` | Missing or invalid Bearer API Key |
| `403` | The API Key lacks permission |
| `500` | Internal service error |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.