---
title: "Retrieve the next domain notification"
method: GET
path: "/v2/customers/{customerId}/domains/notifications"
tags: ["Notifications"]
---

# Retrieve the next domain notification

`GET /v2/customers/{customerId}/domains/notifications`

## Request

- Base URL: `https://api.ote-godaddy.com`
- URL: `https://api.ote-godaddy.com/v2/customers/{customerId}/domains/notifications`
- Auth: none declared

## Path parameters

- `customerId` string, required

## Headers

- `X-Request-Id` string

## Response `200`

Request was successful

- DomainNotification
  - `notificationId` string, required: The notification ID to be used in POST /v2/customers/{customerId}/domains/notifications to acknowledge the notification
  - `type` 'AUTH_CODE_PURCHASE' | 'AUTH_CODE_REGENERATE' | 'AUTO_RENEWAL' | 'BACKORDER' | 'BACKORDER_PURCHASE' | 'BACKORDER_DELETE' | 'BACKORDER_UPDATE' | 'CHANGE_OF_REGISTRANT_DELETE' | 'CONTACT_CREATE' | 'CONTACT_DELETE' | 'CONTACT_UPDATE' | 'DNS_VERIFICATION' | 'DNSSEC_CREATE' | 'DNSSEC_DELETE' | 'DOMAIN_DELETE' | 'DOMAIN_UPDATE' | 'DOMAIN_UPDATE_CONTACTS' | 'DOMAIN_UPDATE_NAME_SERVERS' | 'EXPIRY' | 'HOST_CREATE' | 'HOST_DELETE' | 'ICANN_VERIFICATION' | 'MIGRATE' | 'MIGRATE_IN' | 'PREMIUM' | 'PRIVACY_FORWARDING_UPDATE' | 'PRIVACY_PURCHASE' | 'PRIVACY_DELETE' | 'REDEEM' | 'REGISTER' | 'RENEW' | 'RENEW_UNDO' | 'TRADE' | 'TRADE_CANCEL' | 'TRADE_PURCHASE' | 'TRADE_PURCHASE_AUTH_TEXT_MESSAGE' | 'TRADE_RESEND_AUTH_EMAIL' | 'TRANSFER' | 'TRANSFER_IN' | 'TRANSFER_IN_ACCEPT' | 'TRANSFER_IN_CANCEL' | 'TRANSFER_IN_RESTART' | 'TRANSFER_IN_RETRY' | 'TRANSFER_OUT' | 'TRANSFER_OUT_ACCEPT' | 'TRANSFER_OUT_REJECT' | 'TRANSFER_OUT_REQUESTED' | 'TRANSIT', required: The type of action the notification relates to
  - `resource` string, required: The resource the notification pertains to.
  - `resourceType` 'CONTACT' | 'DOMAIN' | 'HOST', required: The type of resource the notification relates to
  - `status` 'AWAITING' | 'CANCELLED' | 'FAILED' | 'PENDING' | 'SUCCESS', required: The resulting status of the action.
  - `addedAt` string, iso-datetime, required: The date the notification was added
  - `requestId` string: A client provided identifier (via X-Request-Id header) indicating the request this notification is for
  - `metadata` object: The notification data for the given type as specifed by GET /v2/customers/{customerId}/domains/notifications/schema

## Other responses

- `401`: Authentication info not sent or invalid
- `403`: Authenticated user is not allowed access
- `404`: The customer does not exist
- `429`: Too many requests received within interval
- `500`: Internal server error

---

[API](https://skmtc.dev/godaddy/apis/domains-api.md) - [All operations](https://skmtc.dev/godaddy/apis/domains-api/llms.txt) - [OpenAPI document](https://skmtc.dev/godaddy/apis/domains-api/revisions/475bd0561c3c?raw)