---
title: "Service: /members/{member}/uris/forurl [GET]"
source: https://dev.pageseeder.com/api/services/get-uri-forurl_get.html
description: "GET service that retrieves URI information by URL. Returns details like media type, identifiers, and type. Supports optional sharing information. Requires member access to the URI."
last_updated: 2026-09-08T11:52:21+10:00
document_type: api_endpoint
operation_id: uri-GET
resource_id: uri
path_template: /members/{member}/uris/forurl
http_method: GET
api_category: uri
implementation_version: 5.9900
api_since: 5.9900
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~447
---

# /members/\{member\}/uris/forurl \[GET\]

## Description

Specify a URL in the request to retrieve information about a single URI.

This service does not return content, it returns key information about a URI such as media type, identifiers, type and more.

> **Tip:** Use this service when a URL is known, but an identifier or permalink is required.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| url | The url to look for | yes | url |  |
| sharing | Whether to include sharing information | no | boolean | `false` |

## Permission

This service is restricted to a member with access to the URI.

## Response

If found, the corresponding URI is returned as a single [\<uri\>](../elements/element_uri.md) element.

```xml
<uri id="[id]"
     scheme="[scheme]"
     host="[host]"
     port="[port]"
     path="[path]"
     decodedpath="[decodedpath]"
     external="[true|false]"
     [archived="true"]
     [folder="true"]
     [docid="[docid]"]
     [mediatype="[mediatype]"]
     [documenttype="[documenttype]"]
     [title="My Document"]
     [created="[created]"]
     [modified="[modified]"]
     [sharing="[private|shared]"]>
  <displaytitle>My Document</displaytitle>
    [<description>This is my document</description>]
    [<labels>mylabel1,mylabel2</labels>]
 [<sharing hidden="2">
    <share editable="true"
           addcomments="true"
           default="true">
      <group name="my-group1" .../>
    </share>
    <share editable="true"
           addcomments="false">
      <group name="my-group2" .../>
    </share>
    <share editable="false"
           addcomments="true">
      <group name="my-group3" .../>
    </share>
  </sharing>]
</uri>
```

## Error Handling

No specific errors expected for this service.