<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the registration status of each domain bought through Base44 for the app, including when it expires and whether it renews.

Domains you own elsewhere aren't included. Their registration lives with your own registrar.

Only a workspace owner can read registrations, because renewal is managed for the whole workspace.

Fields come back null when the registration can't be read, for example while the registrar is unavailable. That isn't a failure of the call, so read the value again later.

Registrations are ordered by domain name, with cursor-based pagination. To get the next page, send only the cursor from the previous response. It carries limit with it.

Reading registrations is limited to 30 requests a minute per caller. Some workspaces have a different limit.

{
  "registrations": [
    {
      "domain_id": "68b1c0d4e7b91d003c45a1f7",
      "domain": "nordwind-furniture.com",
      "can_manage": true,
      "expires_at": "2027-09-24T00:00:00.000Z",
      "auto_renew": true
    }
  ],
  "pagination": {
    "total": 347,
    "next_cursor": "gAAAAABn7vJ...",
    "has_more": true
  }
}