GET
/contacts/{id}/emailsGET /contacts/{id}/emails
Get email activity for a contact.
Request
curl -X GET 'https://api.sendheron.com/api/v1/contacts/{id}/emails' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
-H 'Content-Type: application/json'Required scopes
The key must carry these:
- contacts:read
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | uuid | Yes | Contact UUID. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Zero-indexed page number. Defaults to 0. |
| limit | integer | No | Items per page. |
| status | string | No | Filter by send status. |
Responses
Returns 200 on success. Errors use standard HTTP status codes: 401 for a missing or invalid key, 403 when the key lacks a required scope, 404 for an unknown id, and 429 when a rate limit window is exhausted.
Rate limits
60 per minute, 150 per 5 minutes, 300 per hour, 2000 per day. All windows apply at once, and the tightest one you breach is the one that rejects the request.