Skip to main content
GET
/
domains
List all domains for the team
curl --request GET \
  --url https://api.lettermint.co/v1/domains \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "domain": "<string>",
      "status": "verified",
      "status_changed_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "path": "<string>",
  "per_page": 123,
  "next_cursor": "<string>",
  "next_page_url": "<string>",
  "prev_cursor": "<string>",
  "prev_page_url": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
sort
string
default:-created_at

Available sorts are domain, created_at, status_changed_at. You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -domain.

​
page[size]
integer
default:30

The number of results that will be returned per page.

​
page[cursor]
string

The cursor to start the pagination from.

​
filter[status]
enum<string>
verified <br/> The domain is active and verified.
partially_verified <br/> Some DNS records of the domain could not be verified.
pending_verification <br/> The domain is new and verification is pending.
failed_verification <br/> The domain verification failed.
Available options:
verified,
partially_verified,
pending_verification,
failed_verification
​
filter[domain]
string

Search by domain name (partial match, case insensitive)

Response

200 - application/json

Paginated set of DomainListData

​
data
DomainListData · object[]
required
​
path
string | null
required

Base path for paginator generated URLs.

​
per_page
integer
required

Number of items shown per page.

​
next_cursor
string | null
required

The "cursor" that points to the next set of items.

​
next_page_url
string<uri> | null
required
​
prev_cursor
string | null
required

The "cursor" that points to the previous set of items.

​
prev_page_url
string<uri> | null
required