---
title: "List emails"
method: GET
path: "/v3/projects/{projectId}/services/{serviceId}/emails"
tags: ["Fax to Email"]
---

# List emails

`GET /v3/projects/{projectId}/services/{serviceId}/emails`

## Request

- Base URL: `https://fax.api.sinch.com`
- URL: `https://fax.api.sinch.com/v3/projects/{projectId}/services/{serviceId}/emails`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.sinch.com/oauth2/token`

List emails for the project.

## Path parameters

- `serviceId` string, required

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

A list of emails associated with the project.

- object
  - `emails` Email[]: List of emails
    - `email` string, email, required
    - `phoneNumbers` Number[], required: Numbers you want to associate with this email.
      - `number` string, phoneNumber: A phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format, including the leading '+'.
      - `permissions` 'both' | 'send' | 'receive': Allows you to set permissions for sending and receiving faxes to this email/phone number combination. Default value is `both`.
    - `projectId` string: The `Id` of the project associated with the call.
    - `createdAt` string, date-time: The date and time the email configuration was created.
    - `updatedAt` string, date-time: The date and time the email configuration was last updated.
  - `page` integer: Current page
  - `totalPages` integer: Total number of pages.
  - `pageSize` integer: Number of items per page.
  - `totalItems` integer: Total size of the result.

## Changes

- **2026-10-08** `7c729cfeab72`: 1 warning, 1 info
  - removed the optional property `allOf[subschema #1]/emails/items/phoneNumbers/items/faxNumber` from the response with the `200` status
  - added the optional property `allOf[subschema #1]/emails/items/phoneNumbers/items/number` to the response with the `200` status
- **2026-10-01** `7f5e54fa9f05`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sinch/apis/fax-api/changes/v3/projects/:projectId/services/:serviceId/emails/get.md)

---

[API](https://skmtc.dev/sinch/apis/fax-api.md) - [All operations](https://skmtc.dev/sinch/apis/fax-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/fax-api/revisions/d3054d7412d5?raw)