List Registrations

client.Registrar.Registrations.List(ctx, params) (*CursorPagination[Registration], error)

GET/accounts/{account_id}/registrar/registrations

Returns a paginated list of domain registrations owned by the account.

This endpoint uses cursor-based pagination. Results are ordered by registration date by default. To fetch the next page, pass the cursor value from the result_info object in the response as the cursor query parameter in your next request. An empty cursor string indicates there are no more pages.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

ParametersExpand Collapse

params RegistrationListParams

AccountID param.Field[string]

Path param: Identifier.

maxLength32

Cursor param.Field[string]Optional

Query param: Opaque token from a previous response’s result_info.cursor. Pass this value to fetch the next page of results. Omit (or pass an empty string) for the first page.

maxLength256

Direction param.Field[RegistrationListParamsDirection]Optional

Query param: Sort direction for results. Defaults to ascending order.

const RegistrationListParamsDirectionAsc RegistrationListParamsDirection = "asc"

const RegistrationListParamsDirectionDesc RegistrationListParamsDirection = "desc"

PerPage param.Field[int64]Optional

Query param: Number of items to return per page.

maximum50

minimum1

SortBy param.Field[RegistrationListParamsSortBy]Optional

Query param: Column to sort results by. Defaults to registration date (registry_created_at) when omitted.

const RegistrationListParamsSortByRegistryCreatedAt RegistrationListParamsSortBy = "registry_created_at"

const RegistrationListParamsSortByRegistryExpiresAt RegistrationListParamsSortBy = "registry_expires_at"

const RegistrationListParamsSortByName RegistrationListParamsSortBy = "name"

ReturnsExpand Collapse

type Registration struct{…}

A domain registration resource representing the current state of a registered domain.

AutoRenew bool

Whether automatic renewal occurs before expiration.

CreatedAt Time

When the domain was registered. Present when the registration resource exists.

formatdate-time

DomainName string

Provides a fully qualified domain name (FQDN), including the extension (e.g., example.com, mybrand.app). The domain name uniquely identifies a registration. Cloudflare permits only one registration per domain, making the domain name a natural idempotency key for registration requests.

ExpiresAt Time

When the domain registration expires. Ready registrations include this value; only registration_pending may return null.

formatdate-time

Locked bool

Whether the domain is locked for transfer.

PrivacyMode RegistrationPrivacyMode

Current WHOIS privacy mode for the registration.

One of the following:

const RegistrationPrivacyModeOff RegistrationPrivacyMode = "off"

const RegistrationPrivacyModeRedaction RegistrationPrivacyMode = "redaction"

Status RegistrationStatus

Current registration status.

active: The domain operates with an active registration.
registration_pending: Registration remains in progress.
expired: The domain registration expired.
suspended: The registry suspended the domain.
redemption_period: The domain entered the redemption grace period.
pending_delete: The registry scheduled the domain for deletion.

One of the following:

const RegistrationStatusActive RegistrationStatus = "active"

const RegistrationStatusRegistrationPending RegistrationStatus = "registration_pending"

const RegistrationStatusExpired RegistrationStatus = "expired"

const RegistrationStatusSuspended RegistrationStatus = "suspended"

const RegistrationStatusRedemptionPeriod RegistrationStatus = "redemption_period"

const RegistrationStatusPendingDelete RegistrationStatus = "pending_delete"

List Registrations

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/registrar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  page, err := client.Registrar.Registrations.List(context.TODO(), registrar.RegistrationListParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}

{
  "errors": [],
  "messages": [],
  "result": [],
  "result_info": {
    "count": 0,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-01-15T10:00:00Z",
      "domain_name": "example.com",
      "expires_at": "2026-01-15T10:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-03-20T14:30:00Z",
      "domain_name": "mybrand.dev",
      "expires_at": "2026-03-20T14:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 2,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-04-01T09:00:00Z",
      "domain_name": "charlie.org",
      "expires_at": "2026-04-01T09:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 1,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2024-01-15T09:30:00Z",
      "domain_name": "acmecorp.com",
      "expires_at": "2026-01-15T09:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-02-20T14:00:00Z",
      "domain_name": "brightwave.net",
      "expires_at": "2026-02-20T14:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-05T11:15:00Z",
      "domain_name": "cloudpeak.org",
      "expires_at": "2026-03-05T11:15:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-22T08:45:00Z",
      "domain_name": "solarpanel.io",
      "expires_at": "2026-03-22T08:45:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-04-10T16:00:00Z",
      "domain_name": "greenleaf.dev",
      "expires_at": "2026-04-10T16:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-05-03T10:30:00Z",
      "domain_name": "swiftrunner.app",
      "expires_at": "2026-05-03T10:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-05-18T13:00:00Z",
      "domain_name": "northerntrail.co",
      "expires_at": "2025-05-18T13:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-01T07:20:00Z",
      "domain_name": "pixelforge.xyz",
      "expires_at": "2026-06-01T07:20:00Z",
      "locked": false,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-25T15:45:00Z",
      "domain_name": "oceandrift.com",
      "expires_at": "2026-06-25T15:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-07-12T09:00:00Z",
      "domain_name": "rocketlaunch.net",
      "expires_at": "2026-07-12T09:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-08-08T12:30:00Z",
      "domain_name": "blueprintlab.io",
      "expires_at": "2026-08-08T12:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-09-01T18:00:00Z",
      "domain_name": "maplewood.org",
      "expires_at": "2026-09-01T18:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-09-20T10:15:00Z",
      "domain_name": "thunderbolt.dev",
      "expires_at": "2025-09-20T10:15:00Z",
      "locked": false,
      "privacy_mode": "off",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-10-05T14:45:00Z",
      "domain_name": "silverbranch.app",
      "expires_at": "2026-10-05T14:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-11-11T08:00:00Z",
      "domain_name": "nightowl.co",
      "expires_at": "2026-11-11T08:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-12-01T11:30:00Z",
      "domain_name": "crimsongate.com",
      "expires_at": "2026-12-01T11:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-01-07T16:20:00Z",
      "domain_name": "frostedpine.net",
      "expires_at": "2027-01-07T16:20:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-01-25T09:50:00Z",
      "domain_name": "horizonline.xyz",
      "expires_at": "2027-01-25T09:50:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-02-14T13:00:00Z",
      "domain_name": "coppervine.io",
      "expires_at": "2027-02-14T13:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-03-02T07:40:00Z",
      "domain_name": "starlitpath.org",
      "expires_at": "2027-03-02T07:40:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 20,
    "cursor": "eyJ0IjoiMjAyNS0wNi0xNVQxMjowMDowMC4wMDAwMDBaIiwibiI6ImJyYXZvLm5ldCJ9",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [
    {
      "code": 10000,
      "message": "Invalid pagination cursor"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}

Returns Examples

{
  "errors": [],
  "messages": [],
  "result": [],
  "result_info": {
    "count": 0,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-01-15T10:00:00Z",
      "domain_name": "example.com",
      "expires_at": "2026-01-15T10:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-03-20T14:30:00Z",
      "domain_name": "mybrand.dev",
      "expires_at": "2026-03-20T14:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 2,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-04-01T09:00:00Z",
      "domain_name": "charlie.org",
      "expires_at": "2026-04-01T09:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 1,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2024-01-15T09:30:00Z",
      "domain_name": "acmecorp.com",
      "expires_at": "2026-01-15T09:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-02-20T14:00:00Z",
      "domain_name": "brightwave.net",
      "expires_at": "2026-02-20T14:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-05T11:15:00Z",
      "domain_name": "cloudpeak.org",
      "expires_at": "2026-03-05T11:15:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-22T08:45:00Z",
      "domain_name": "solarpanel.io",
      "expires_at": "2026-03-22T08:45:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-04-10T16:00:00Z",
      "domain_name": "greenleaf.dev",
      "expires_at": "2026-04-10T16:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-05-03T10:30:00Z",
      "domain_name": "swiftrunner.app",
      "expires_at": "2026-05-03T10:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-05-18T13:00:00Z",
      "domain_name": "northerntrail.co",
      "expires_at": "2025-05-18T13:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-01T07:20:00Z",
      "domain_name": "pixelforge.xyz",
      "expires_at": "2026-06-01T07:20:00Z",
      "locked": false,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-25T15:45:00Z",
      "domain_name": "oceandrift.com",
      "expires_at": "2026-06-25T15:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-07-12T09:00:00Z",
      "domain_name": "rocketlaunch.net",
      "expires_at": "2026-07-12T09:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-08-08T12:30:00Z",
      "domain_name": "blueprintlab.io",
      "expires_at": "2026-08-08T12:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-09-01T18:00:00Z",
      "domain_name": "maplewood.org",
      "expires_at": "2026-09-01T18:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-09-20T10:15:00Z",
      "domain_name": "thunderbolt.dev",
      "expires_at": "2025-09-20T10:15:00Z",
      "locked": false,
      "privacy_mode": "off",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-10-05T14:45:00Z",
      "domain_name": "silverbranch.app",
      "expires_at": "2026-10-05T14:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-11-11T08:00:00Z",
      "domain_name": "nightowl.co",
      "expires_at": "2026-11-11T08:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-12-01T11:30:00Z",
      "domain_name": "crimsongate.com",
      "expires_at": "2026-12-01T11:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-01-07T16:20:00Z",
      "domain_name": "frostedpine.net",
      "expires_at": "2027-01-07T16:20:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-01-25T09:50:00Z",
      "domain_name": "horizonline.xyz",
      "expires_at": "2027-01-25T09:50:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-02-14T13:00:00Z",
      "domain_name": "coppervine.io",
      "expires_at": "2027-02-14T13:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-03-02T07:40:00Z",
      "domain_name": "starlitpath.org",
      "expires_at": "2027-03-02T07:40:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 20,
    "cursor": "eyJ0IjoiMjAyNS0wNi0xNVQxMjowMDowMC4wMDAwMDBaIiwibiI6ImJyYXZvLm5ldCJ9",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [
    {
      "code": 10000,
      "message": "Invalid pagination cursor"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}