---
title: "GET /external_locations"
method: GET
path: "/external_locations"
tags: ["ExternalLocationsService"]
---

# GET /external_locations

`GET /external_locations`

List external locations

## Query parameters

- `maxResults` integer
- `pageToken` string
- `includeBrowse` boolean

## Response `200`

OK

- ListExternalLocationsResponse — List external locations response.
  - `externalLocations` ExternalLocationInfo[] — The external locations returned.
    - `name` string — Name of the external location.
    - `url` string — Path URL of the external location.
    - `credentialName` string — Name of the storage credential used with this location.
    - `readOnly` boolean — Indicates whether the external location is read-only.
    - `comment` string — User-provided free-form text description.
    - `owner` string — The owner of the external location.
    - `credentialId` string — Unique ID of the location's storage credential.
    - `createdAt` string — Time at which this catalog was created, in epoch milliseconds.
    - `createdBy` string — Username of catalog creator.
    - `updatedAt` string — Time at which this catalog was last updated, in epoch milliseconds.
    - `updatedBy` string — Username of user who last modified catalog.
    - `browseOnly` boolean — Indicates whether the principal is limited to retrieving metadata for the associated object through the BROWSE privilege when include_browse is enabled in the request.
    - `externalLocationId` string
  - `nextPageToken` string — The next_page_token value to include in the next List request.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/delta-incubator/apis/delta-sharing-api.md) · [All operations](https://skmtc.net/delta-incubator/apis/delta-sharing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/delta-incubator/delta-sharing-api/versions/a47a0389fffc/schema)