---
title: "List external links"
method: GET
path: "/properties-api/listing-settings/external-links/{propertyId}"
tags: ["Listing external links"]
---

# List external links

`GET /properties-api/listing-settings/external-links/{propertyId}`

Returns all external links for the given property (listing). Each item has id, url, and name. Use the id values for update (PUT), delete (DELETE), or reorder (PUT order). Empty array if the property has no links yet.

## Path parameters

- `propertyId` string, required

## Response `200`

Array of external links in display order. Empty array [] if none exist.

- object[]
  - `id` string, required — Unique id of the link. Use for update (PUT :propertyId/:linkId), delete (DELETE), or reorder (PUT :propertyId/order).
  - `url` string, required — URL of the link (with protocol).
  - `name` string, required — Display name shown to users.

## Other responses

- `401` — Missing or invalid authentication. Account ID is required.
- `403` — You do not have permission to perform this action on the property.

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)