v14

latestOpenAPI 3.0.32026-08-04377889.4 MB
projects

Retrieve project domains by project by id or name

Retrieve the domains associated with a given project by passing either the project id or name in the URL.

get/v9/projects/{idOrName}/domains

Path parameters

idOrNamestring required

The unique project identifier or the project name

The unique project identifier or the project name

Query parameters

production'true' | 'false'

Filters only production domains when set to true.

Filters only production domains when set to true.

target'production' | 'preview'

Filters on the target of the domain. Can be either "production", "preview"

Filters on the target of the domain. Can be either "production", "preview"

customEnvironmentIdstring

The unique custom environment identifier within the project

Example:env_123abc4567

The unique custom environment identifier within the project

gitBranchstring

Filters domains based on specific branch.

Filters domains based on specific branch.

redirects'true' | 'false'

Excludes redirect project domains when "false". Includes redirect project domains when "true" (default).

Excludes redirect project domains when "false". Includes redirect project domains when "true" (default).

redirectstring

Filters domains based on their redirect target.

Example:example.com

Filters domains based on their redirect target.

verified'true' | 'false'

Filters domains based on their verification status.

Filters domains based on their verification status.

limitnumber

Maximum number of domains to list from a request (max 100).

Example:20

Maximum number of domains to list from a request (max 100).

sincenumber

Get domains created after this JavaScript timestamp.

Example:1609499532000

Get domains created after this JavaScript timestamp.

untilnumber

Get domains created before this JavaScript timestamp.

Example:1612264332000

Get domains created before this JavaScript timestamp.

order'ASC' | 'DESC'

Domains sort order by createdAt

Domains sort order by createdAt

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

Successful response retrieving a list of domains

OR

Example response

{
  "pagination": {
    "count": 20,
    "next": 1540095775951,
    "prev": 1540095775951
  }
}