---
title: "Service: /groups/{group}/uris/{uri}/uris [GET]"
source: https://dev.pageseeder.com/api/services/list-uri-uris-GET.html
description: "GET service that lists URIs with a specified relationship to a given URI. Supports filtering by type (document/folder), pagination, and exclusion paths. Returns XML with URI details including ID, path, and display title."
last_updated: 2026-09-02T11:36:18+10:00
document_type: api_endpoint
operation_id: uri-GET
resource_id: uri
path_template: /groups/{group}/uris/{uri}/uris
http_method: GET
api_category: uri
implementation_version: 6.3000
api_since: 5.6900
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: null
generated_at: 2026-09-02
tokens: ~383
---

# /groups/\{group\}/uris/\{uri\}/uris \[GET\]

## Description

List all the URIs with a particular relationship to a specified URI.

> **Note:** This services will not work for external URIs.

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| exclude | Exclude URIs under this folder path relative to URI (e.g. archive) | no | string |  |
| 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 specified URL, can be `children`, `descendants`, `ancestors`, `ancestors-siblings` or `siblings` | no | enum | `children` |
| type | The type of URIs to return, can be `document`, `folder` or `all`. | no | enum | `all` |

If `relationship=ancestors-siblings` then ancestors and siblings of the the URI are returned including siblings of all the ancestors, and children of the URI.

If `relationship=children` or `siblings` then the URIs are ordered with folders returned first, then alphabetically on title and then alphabetically on path, otherwise they are ordered by path.

## Permission

This service is restricted to guest and higher unless the group is accessible to public.

## Response

The output has the following format:

```xml

<uris>
  <uri id="[id]" path="[path]" ...>
    <!-- All URI's attribute are included -->
    <displaytitle>[title]</displaytitle>
  </uri>
  ...
</uris>
```

## Error Handling

No specific errors expected for this service.