---
title: "Get a usage-rights record"
method: GET
path: "/usage-rights/requests/{usage_right_id}"
tags: ["Usage Rights"]
---

# Get a usage-rights record

`GET /usage-rights/requests/{usage_right_id}`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/usage-rights/requests/{usage_right_id}`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

One usage-rights record by id, scoped to this shop. Returns 404 if the record doesn't exist or belongs to another shop. Single shop only.

## Path parameters

- `usage_right_id` string, required

## Response `200`

Successful Response

- UsageRightsRecordResponse
  - `data` UsageRightsRecord, required: A single usage-rights record (the portal's full detail shape).
    - `id` string, required
    - `videoId` string, required
    - `shopId` integer, nullable
    - `creatorId` string, required
    - `creatorAccountId` integer, nullable
    - `messageText` string, nullable
    - `isPaidOffer` boolean
    - `offerAmount` number
    - `currency` string
    - `usageRightsMonths` integer, nullable
    - `usageRightsScope` string, nullable
    - `usageExclusivityEnabled` boolean, nullable
    - `usageExclusivityMonths` integer, nullable
    - `agreementClause` string, nullable
    - `status` string
    - `dmStatus` string
    - `dmSentAt` string, nullable
    - `dmError` string, nullable
    - `gcsVideoPath` string, nullable
    - `respondedAt` string, nullable
    - `cancelledAt` string, nullable
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-03** `30786bf76d4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/usage-rights/requests/:usage_right_id/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)