---
title: "Get a registration"
method: GET
path: "/appmail/registrations/{id}"
tags: ["App Mail Registrations"]
---

# Get a registration

`GET /appmail/registrations/{id}`

## Request

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

Returns one app mail registration of the caller's tenant. Returns 400 (not 404) if it is not found.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- AppMailRegistrationValue: A mailbox registered with AppMail.
  - `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)