---
title: "Retrieve a Request"
method: GET
path: "/v2/requests/{requestId}"
tags: ["Requests"]
---

# Retrieve a Request

`GET /v2/requests/{requestId}`

This endpoint allows you to retrieve a request by providing a request ID.

## Path parameters

- `requestId` string, required

## Response `200`

Returns a Request

- object
  - `id` string, uuid, required
  - `method` string, required
  - `endpoint` string, required
  - `body` string, nullable
  - `createdAt` union, required
    - string
    - string
  - `transaction` object, nullable
    - `id` string, required — Transaction ID that identifies the Transaction generated by an API request
    - `type` 'ORG_CREATE' | 'PROJECT_CREATE' | 'PROJECT_NFT_BATCH' | 'PROJECT_SFT_BATCH' | 'PROJECT_NFT_BURN' | 'PROJECT_NFT_REVOKE' | 'PROJECT_NFT_UPDATE' | 'PROJECT_ROYALTIES_WITHDRAW' | 'PROJECT_UPDATE' | 'CORE_PROJECT_CREATE' | 'CORE_PROJECT_UPDATE' | 'CORE_PROJECT_ASSET_CREATE' | 'CORE_PROJECT_ASSET_UPDATE' | 'CORE_PROJECT_ASSET_BATCH' | 'PROJECT_NFT_CREATE' | 'PROJECT_SFT_CREATE' | 'PROJECT_NFT_TRANSFER' | 'PROJECT_ASSET_TRANSFER' | 'PROJECT_ASSET_BURN' | 'PROJECT_ASSET_UPDATE' | 'SHOP_CREATE' | 'DUST_CREATE' | 'NON_TRANSFERABLE_PROJECT_CREATE' | 'TRANSFERABLE_PROJECT_CREATE' | 'TRANSFERABLE_PROJECT_NFT_CREATE' | 'INSCRIPTION_CREATE' | 'SNAPSHOT_CREATE' | 'TOKEN22_CREATE' | 'TOKEN_CREATE' | 'TOKEN_RENOUNCE' | 'TOKEN_MINT' | 'TREE_CREATE', required
  - `response` object, nullable
    - `id` string, required
    - `status` number, required
    - `body` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/underdogprotocol/apis/underdog-protocol-api.md) · [All operations](https://skmtc.dev/underdogprotocol/apis/underdog-protocol-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/underdogprotocol/underdog-protocol-api/revisions/714574b82cc5/schema)