---
title: "List registrations"
method: GET
path: "/appmail/registrations"
tags: ["App Mail Registrations"]
---

# List registrations

`GET /appmail/registrations`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/appmail/registrations`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token`

Returns all app mail registrations of the caller's tenant (not paginated).

## Response `200`

OK

- AppMailRegistrationValue[]
  - `tenantId` string, uuid
  - `createdDate` string, date-time
  - `createdBy` string, uuid
  - `creatorName` string
  - `lastModifiedDate` string, date-time
  - `lastModifiedBy` string, uuid
  - `version` integer
  - `id` string, uuid: Registration ID.
  - `email` string: Registered email address.
  - `userId` string, uuid: User the registration is assigned to; null for tenant-level registrations.
  - `userName` string: Full name of the assigned user.
  - `primary` boolean: True if this is the primary registration of the user (their own registered email). Primary registrations cannot be deleted or reassigned.
  - `status` 'PENDING' | 'VERIFIED': PENDING until the address is confirmed through the emailed link, then VERIFIED.
  - `deletable` boolean: Whether the registration can be deleted (false for primary registrations).

---

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