---
title: "Service: /groups/{group}/uris/{uri}/xrefs [GET]"
source: https://dev.pageseeder.com/api/services/list-uri-xrefs_get.html
description: "This GET service loads all cross-references (xrefs) for a specified URI, returning both forward and reverse xrefs with optional filtering by type and pagination support. Restricted to guest access or higher unless the group is public."
last_updated: 2026-09-08T11:47:40+10:00
document_type: api_endpoint
operation_id: xref-GET
resource_id: xref
path_template: /groups/{group}/uris/{uri}/xrefs
http_method: GET
api_category: xref
implementation_version: 6.3000
api_since: 4.9500
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~462
---

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

## Description

Load a [URI](../../reference/glossary/uri.md)'s [xrefs](../../reference/glossary/cross_reference.md).

Returns all xrefs from the given URI.

> **Note:** Does not return reverse xrefs for external URIs (URLs). Use list URI reversexrefs service instead.

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| forward | Whether to include forward xrefs | no | boolean | `true` |
| includetypes | A comma-separated list of types of xrefs to include (`none, embed,transclude`) | no | integer |  |
| page | The page to load | no | integer | `1` |
| pagesize | The number of results per page | no | integer | `1000` |
| publicationid | The `ID` of the publication for `version` parameter | no | publicationid |  |
| reverse | Whether to include reverse xrefs | no | boolean | `true` |
| version | Version of the document | no | string |  |
| versionid | Version `id` of the document | no | integer |  |

## Permission

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

## Response

Format is as follows (ordered by `urititle` then `title`):

```xml
<uri id=[id] ... >
  <!-- URI details -->
  <displaytitle>[displaytitle]</displaytitle>
  ...
  <!-- Xrefs found -->
  <xrefs>
    <xref title="[title]"
          urititle="[target URI title]"
          uriid="[target ID]" ..... />
    <xref title="[title]"
          urititle="[target URI title]"
          uriid="[target ID]" ..... />
    ...
  </xrefs>
  <!-- Reverse Xrefs found, if required -->
  <reversexrefs>
    <reversexref title="[title]"
                 urititle="[source URI title]"
                 uriid="[source ID]" ..... />
    ...
    </reversexrefs>
</uri>
```

## Error Handling

No specific errors expected for this service.