---
title: "Get all incoming email logs"
method: GET
path: "/entity/{entityId}/emailLogs"
tags: ["entity > email-log"]
---

# Get all incoming email logs

`GET /entity/{entityId}/emailLogs`

## Request

- Base URL: `https://api.mercoa.com`
- URL: `https://api.mercoa.com/entity/{entityId}/emailLogs`
- Auth: HTTP bearer

Get all incoming invoice emails for an entity.

## Path parameters

- `entityId` string, required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `limit` integer
- `startingAfter` string
- `search` string

## Response `200`

Response with status 200

- EmailLogTypesEmailLogResponse
  - `count` integer, required: Total number of logs for the given filters. This value is not limited by the limit parameter. It is provided so that you can determine how many pages of results are available.
  - `hasMore` boolean, required: True if there are more logs available for the given filters.
  - `data` EmailLogTypesEmailLog[], required
    - `id` string, required
    - `status` 'PENDING' | 'PROCESSED' | 'FAILED', required
    - `subject` string, required
    - `from` string, required
    - `to` string, required
    - `htmlBody` string, required
    - `textBody` string, required
    - `attachment` EmailLogTypesEmailLogAttachment
      - `filename` string, required
      - `contentType` string, required
    - `createdAt` string, date-time, required
    - `invoiceId` string

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `403`: Error response with status 403
- `404`: Error response with status 404
- `409`: Error response with status 409
- `500`: Error response with status 500
- `501`: Error response with status 501

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)