List all the domains - Vercel API Docs

GET

domains

import { Vercel } from "@vercel/sdk";

const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await vercel.domains.getDomains({
    limit: 20,
    since: 1609499532000,
    until: 1612264332000,
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
    slug: "my-team-url-slug",
  });

  // Handle the result
  console.log(result);
}

run();

{
  "domains": [
    {
      "verified": true,
      "nameservers": [
        "ns1.nameserver.net",
        "ns2.nameserver.net"
      ],
      "intendedNameservers": [
        "ns1.vercel-dns.com",
        "ns2.vercel-dns.com"
      ],
      "customNameservers": [
        "ns1.nameserver.net",
        "ns2.nameserver.net"
      ],
      "creator": {
        "id": "ZspSRT4ljIEEmMHgoDwKWDei",
        "username": "vercel_user",
        "email": "demo@example.com"
      },
      "teamId": "<string>",
      "createdAt": 1613602938882,
      "boughtAt": 1613602938882,
      "expiresAt": 1613602938882,
      "id": "EmTbe5CEJyTk2yVAHBUWy4A3sRusca3GCwRjTC1bpeVnt1",
      "name": "example.com",
      "orderedAt": 1613602938882,
      "renew": true,
      "serviceType": "zeit.world",
      "transferredAt": 1613602938882,
      "transferStartedAt": 1613602938882,
      "userId": "<string>"
    }
  ],
  "pagination": {
    "count": 20,
    "next": 1540095775951,
    "prev": 1540095775951
  }
}

Authorizations

Authorization

string

header

required

Default authentication mechanism

Query Parameters

limit

number

Maximum number of domains to list from a request.

Example:

20

since

number

Get domains created after this JavaScript timestamp.

Example:

1609499532000

until

number

Get domains created before this JavaScript timestamp.

Example:

1612264332000

teamId

string

The Team identifier to perform the request on behalf of.

Example:

"team_1a2b3c4d5e6f7g8h9i0j1k2l"

slug

string

The Team slug to perform the request on behalf of.

Example:

"my-team-url-slug"

Response

200

application/json

Successful response retrieving a list of domains.

domains

object[]

required

domains.verified

boolean

required

If the domain has the ownership verified.

Example:

true

domains.nameservers

string[]

required

A list of the current nameservers of the domain.

Example:

["ns1.nameserver.net", "ns2.nameserver.net"]

domains.intendedNameservers

string[]

required

A list of the intended nameservers for the domain to point to Vercel DNS.

Example:

["ns1.vercel-dns.com", "ns2.vercel-dns.com"]

domains.creator

object

required

An object containing information of the domain creator, including the user's id, username, and email.

Example:

{
  "id": "ZspSRT4ljIEEmMHgoDwKWDei",
  "username": "vercel_user",
  "email": "demo@example.com"
}

domains.teamId

string | null

required

domains.createdAt

number

required

Timestamp in milliseconds when the domain was created in the registry.

Example:

1613602938882

domains.boughtAt

number | null

required

If it was purchased through Vercel, the timestamp in milliseconds when it was purchased.

Example:

1613602938882

domains.expiresAt

number | null

required

Timestamp in milliseconds at which the domain is set to expire. null if not bought with Vercel.

Example:

1613602938882

domains.id

string

required

The unique identifier of the domain.

Example:

"EmTbe5CEJyTk2yVAHBUWy4A3sRusca3GCwRjTC1bpeVnt1"

domains.name

string

required

The domain name.

Example:

"example.com"

domains.serviceType

enum<string>

required

The type of service the domain is handled by. external if the DNS is externally handled, zeit.world if handled with Vercel, or na if the service is not available.

Available options:

zeit.world,

external,

na

Example:

"zeit.world"

domains.userId

string

required

domains.customNameservers

string[]

A list of custom nameservers for the domain to point to. Only applies to domains purchased with Vercel.

Example:

["ns1.nameserver.net", "ns2.nameserver.net"]

domains.orderedAt

number

Timestamp in milliseconds at which the domain was ordered.

Example:

1613602938882

domains.renew

boolean

Indicates whether the domain is set to automatically renew.

Example:

true

domains.transferredAt

number | null

Timestamp in milliseconds at which the domain was successfully transferred into Vercel. null if the transfer is still processing or was never transferred in.

Example:

1613602938882

domains.transferStartedAt

number

If transferred into Vercel, timestamp in milliseconds when the domain transfer was initiated.

Example:

1613602938882

pagination

object

required

This object contains information related to the pagination of the current request, including the necessary parameters to get the next or previous page of data.

Get Information for a Single Domain Register or transfer-in a new Domain

import { Vercel } from "@vercel/sdk";

const vercel = new Vercel({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await vercel.domains.getDomains({
    limit: 20,
    since: 1609499532000,
    until: 1612264332000,
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
    slug: "my-team-url-slug",
  });

  // Handle the result
  console.log(result);
}

run();

{
  "domains": [
    {
      "verified": true,
      "nameservers": [
        "ns1.nameserver.net",
        "ns2.nameserver.net"
      ],
      "intendedNameservers": [
        "ns1.vercel-dns.com",
        "ns2.vercel-dns.com"
      ],
      "customNameservers": [
        "ns1.nameserver.net",
        "ns2.nameserver.net"
      ],
      "creator": {
        "id": "ZspSRT4ljIEEmMHgoDwKWDei",
        "username": "vercel_user",
        "email": "demo@example.com"
      },
      "teamId": "<string>",
      "createdAt": 1613602938882,
      "boughtAt": 1613602938882,
      "expiresAt": 1613602938882,
      "id": "EmTbe5CEJyTk2yVAHBUWy4A3sRusca3GCwRjTC1bpeVnt1",
      "name": "example.com",
      "orderedAt": 1613602938882,
      "renew": true,
      "serviceType": "zeit.world",
      "transferredAt": 1613602938882,
      "transferStartedAt": 1613602938882,
      "userId": "<string>"
    }
  ],
  "pagination": {
    "count": 20,
    "next": 1540095775951,
    "prev": 1540095775951
  }
}

Endpoints

Authorizations

Query Parameters

Response