# List emails

Retrieve emails from your unified inbox. Filter by contact, sender profile, mailbox, type (inbox/outbox), status, and date range.

Endpoint: GET /emails/api/emails
Version: 2.0.0
Security: bearerAuth

## Query parameters:

  - `limit` (integer)
    Items per page (default 20).
    Example: 20

  - `offset` (integer)
    Items to skip (default 0).

  - `order_field` (string)
    Sort field (default created_at).
    Example: "created_at"

  - `order_type` (string)
    Sort direction.
    Enum: "asc", "desc"

  - `filter` (object)

## Response 200 fields (application/json):

  - `data` (array)

  - `data.uuid` (string)

  - `data.team_id` (integer)

  - `data.user_id` (integer)

  - `data.sender_profile_uuid` (string)

  - `data.mailbox_uuid` (string)

  - `data.email_body_uuid` (string)

  - `data.flow_uuid` (string,null)

  - `data.lead_uuid` (string)

  - `data.status` (string)

  - `data.type` (string)
    inbox or outbox.

  - `data.from_name` (string)

  - `data.from_email` (string)

  - `data.to_name` (string)

  - `data.to_email` (string)

  - `data.cc` (array)

  - `data.bcc` (array)

  - `data.subject` (string)

  - `data.replied_to_uuid` (string,null)

  - `data.bounced_by_uuid` (string,null)

  - `data.sent_at` (string,null)

  - `data.created_at` (string)

  - `data.updated_at` (string)

  - `limit` (integer)

  - `offset` (integer)

  - `total` (integer)