---
title: "Service: /hosts/{host}/externaluris [GET]"
source: https://dev.pageseeder.com/api/services/list-host-externaluris-GET.html
description: "GET service that retrieves all external URIs for a specified host within a group. Supports pagination, filtering by archive status, and relationship type (children or descendants). Returns XML with URI elements including metadata and display titles."
last_updated: 2026-09-02T11:36:08+10:00
document_type: api_endpoint
operation_id: uri-GET
resource_id: uri
path_template: /hosts/{host}/externaluris
http_method: GET
api_category: uri
implementation_version: 6.3000
api_since: 5.9900
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~296
---

# /hosts/\{host\}/externaluris \[GET\]

## Description

Load all the external [URIs](../../reference/glossary/uri.md) for a specified host in the group specified in the request.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| archived | Include archived URIs | no | boolean | `false` |
| archivedfolders | Include archived folder URIs | no | boolean | `false` |
| page | The page to load | no | integer | `1` |
| pagesize | The number of results per page | no | integer | `200` |
| relationship | The relationship of returned URIs to host, can be `children`, `descendants` | no | enum | `children` |
| type | The type of URIs to return, can be `folder` | no | string |  |

## Permission

This service is restricted to guest and higher.

## Response

The URI for the host are listed in as [\<uri\>](../elements/element_uri.md) elements wrapped in a `<uris>` element:

```xml

<uris>
  <uri id="[id]" path="[crole]" ...>
    <!-- All URI's attribute are included -->
    <displaytitle type="text/plain">[content of version]</displaytitle>
  </uri>
  ...
</uris>
```

## Error Handling

No specific errors expected for this service.