---
title: "List external locations"
method: GET
path: "/external-locations"
tags: ["External Locations"]
---

# List external locations

`GET /external-locations`

## Request

- Base URL: `http://localhost:8080/api/2.1/unity-catalog`
- URL: `http://localhost:8080/api/2.1/unity-catalog/external-locations`
- Auth: none declared

Gets an array of external locations (ExternalLocationInfo objects) from the metastore. The caller must be a metastore admin, the owner of the external location, or a user with some privilege on the external location.

## Query parameters

- `max_results` integer
- `page_token` string

## Response `200`

The external location list was successfully retrieved.

- ListExternalLocationsResponse
  - `external_locations` ExternalLocationInfo[]: An array of external locations.
    - `name` string: Name of the external location.
    - `id` string: Unique identifier for the external location.
    - `url` string: Path URL of the external location.
    - `credential_name` string: Name of the storage credential used with this location.
    - `comment` string: User-provided free-form text description.
    - `owner` string: The owner of the external location.
    - `credential_id` string: Unique ID of the location's storage credential.
    - `created_at` integer: Time at which this external location was created, in epoch milliseconds.
    - `created_by` string: Username of external location creator.
    - `updated_at` integer: Time at which external location this was last modified, in epoch milliseconds.
    - `updated_by` string: Username of user who last modified the external location.
  - `next_page_token` string: Opaque token to retrieve the next page of results. Absent if there are no more pages. __page_token__ should be set to this value for the next request (for the next page of results).

## Changes

- **2026-01-06** `b6821a550f7f`: 1 info
  - added the optional property `external_locations/items/id` to the response with the `200` status
- **2025-03-24** `ed1fa6308c2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/external-locations/get.md)

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) - [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/revisions/c84507f0d7e0?raw)