---
title: "Retrieve a GUID resource or redirect to its referent resource"
method: GET
path: "/guids/{guid_id}/"
tags: ["GUIDs"]
---

# Retrieve a GUID resource or redirect to its referent resource

`GET /guids/{guid_id}/`

Retrieve a GUID object or be redirected to the most appropriate resource.

By default, this endpoint redirects (`302 Found`) to the resource URL associated with the GUID.
If `?resolve=false` is passed, it returns the GUID resource object instead of redirecting.

GUIDs may reference nodes, registrations, files, collections, preprints, or users.

### Redirect Behavior
- If the GUID refers to a supported resource, this will redirect to its detail endpoint.
- If it refers to an unsupported type (e.g., wiki), `501 Not Implemented` is returned.
- If the GUID is invalid or deleted, a `404` or `410` is returned.

### JSON Response Behavior
- If `resolve=false` is used, a `200 OK` is returned with the GUID resource object.

### Permissions
- Public GUIDs are accessible without authentication.
- Private GUIDs require appropriate access permissions.

## Path parameters

- `guid_id` string, required

## Query parameters

- `resolve` boolean

## Response `200`

Successfully retrieved the GUID resource.

## Other responses

- `302` — Redirects to the referent resource if `resolve=true` or omitted.
- `401` — Authentication required.
- `403` — You do not have permission to view this GUID.
- `404` — GUID not found.
- `410` — The GUID has been deleted.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/ca701048eb0d/schema)