GoDaddy
Support
API ReferenceDomainDomain LifecycleDomains & DNSv3 (Recommended)RegistrationsGet a registration record GET

Get a registration record

View as Markdown

Returns a single registration record by its server-assigned registrationId, including the current execution status and the domain expiry date once the registration completes.

Full description

Returns a single registration record by its server-assigned registrationId, including the current execution status and the domain expiry date once the registration completes. This is the concrete poll endpoint for registration operations; the abstract equivalent is GET /operations/{operationId}.

GET
/registrations/{registrationId}

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Path Parameters

registrationId*string

Server-assigned registration identifier.

Formatuuid

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/registrations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "registrationId": null,  "domain": "string",  "period": 1,  "profileId": null,  "profile": {    "contacts": {      "registrant": {        "firstName": "string",        "lastName": "string",        "organization": "string",        "email": "string",        "phone": {          "countryCode": "str",          "nationalNumber": "string",          "extensionNumber": "string"        },        "address": {          "line1": "string",          "line2": "string",          "city": "string",          "state": "string",          "countryCode": "st",          "postalCode": "string"        }      },      "admin": {        "firstName": "string",        "lastName": "string",        "organization": "string",        "email": "string",        "phone": {          "countryCode": "str",          "nationalNumber": "string",          "extensionNumber": "string"        },        "address": {          "line1": "string",          "line2": "string",          "city": "string",          "state": "string",          "countryCode": "st",          "postalCode": "string"        }      },      "tech": {        "firstName": "string",        "lastName": "string",        "organization": "string",        "email": "string",        "phone": {          "countryCode": "str",          "nationalNumber": "string",          "extensionNumber": "string"        },        "address": {          "line1": "string",          "line2": "string",          "city": "string",          "state": "string",          "countryCode": "st",          "postalCode": "string"        }      },      "billing": {        "firstName": "string",        "lastName": "string",        "organization": "string",        "email": "string",        "phone": {          "countryCode": "str",          "nationalNumber": "string",          "extensionNumber": "string"        },        "address": {          "line1": "string",          "line2": "string",          "city": "string",          "state": "string",          "countryCode": "st",          "postalCode": "string"        }      }    },    "autoRenew": true,    "privacy": true,    "nameServers": [      "string",      "string"    ]  },  "quoteToken": null,  "consent": {    "agreementTypes": [      "string"    ],    "agreedAt": "string",    "acknowledgedFees": [      {        "type": null,        "fee": {          "currencyCode": "str",          "value": 0        }      }    ],    "agreedBy": {      "type": null,      "principal": "string",      "actor": "string",      "ip": "string"    }  },  "price": {    "currencyCode": "str",    "value": 0  },  "fees": [    {      "type": null,      "fee": {        "currencyCode": "str",        "value": 0      }    }  ],  "status": null,  "operationId": null,  "expiresAt": "string",  "createdAt": "string",  "updatedAt": "string",  "links": [    {      "href": "http://example.com",      "rel": "string",      "title": "string",      "targetMediaType": "string",      "targetSchema": null,      "method": "string",      "submissionMediaType": "application/json",      "submissionSchema": null    }  ]}

Agent & Automation Notes

Scopesdomains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:update
Rate limit60 req/min per credential
On failureGET operations are safe to retry. POST registrations use Idempotency-Key. Poll async operations — do not resubmit.

Related

Last updated on

How is this guide?