---
title: "Lists all available GTD locations."
method: GET
path: "/gtdlocations"
tags: ["gtdLocation"]
---

# Lists all available GTD locations.

`GET /gtdlocations`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/gtdlocations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/gtdlocations/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lists all available GTD locations, helping users review and configure their global traffic distribution settings.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive data retrieval:** Returns a comprehensive list of all GTD locations, providing a complete and accurate overview for seamless management and analysis.</br>- **Dynamic filtering:** Uses the `name` parameter to filter results, streamlining access to specific locations and enhancing data retrieval efficiency.

## Query parameters

- `name` string

## Response `200`

GTD locations listed successfully.

- GTDLocation[]
  - `gtdLocationId` integer
  - `name` string
  - `label` string
  - `sort` integer
  - `resolvingNSFQDN` string
  - `description` string

## Other responses

- `404`: GTD locations not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)