> For the complete documentation index, see [llms.txt](https://api-docs.rightsline.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.rightsline.com/entities/royalty/retrieve-a-royalty.md).

# Retrieve a royalty

## Get royalty

<mark style="color:blue;">`GET`</mark> `https://ris.rightsline.com/v4/royalty/:id`

This endpoint allows you to retrieve a specific royalty by ID.

#### Path Parameters

| Name | Type    | Description                    |
| ---- | ------- | ------------------------------ |
| id   | integer | ID of the royalty to retrieve. |

#### Headers

| Name           | Type   | Description             |
| -------------- | ------ | ----------------------- |
| x-api-key      | string | Your company's API key. |
| Authentication | string | Authentication token.   |

{% tabs %}
{% tab title="200 Royalty successfully retrieved." %}

```json
{
  "parentRelationship": null,
  "id": 100,
  "revisionId": 0,
  "title": "Test Royalty",
  "template": {
    "fields": [],
    "templateId": 1,
    "templateName": "Standard Royalty",
    "processId": 0,
    "processName": null
  },
  "status": {
    "statusId": 1,
    "statusName": "Active"
  },
  "characteristics": {},
  "comments": [],
  "createdById": 1,
  "createdDate": "2024-01-15T10:00:00.000Z",
  "lastUpdatedById": 1,
  "lastUpdatedDate": "2024-01-15T10:00:00.000Z"
}
```

{% endtab %}

{% tab title="404 Could not find a royalty with this ID." %}

```json
{
  "message": "Resource Not Found"
}
```

{% endtab %}
{% endtabs %}