Skip to main content
GET
/
asset
/
{id}
Get asset by ID
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/asset/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "type": "object",
    "required": [
      "title",
      "mainArtist",
      "displayArtist",
      "type"
    ],
    "properties": {
      "title": {
        "type": "string",
        "example": "Midnight City"
      },
      "mainArtist": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "M83",
          "M47"
        ]
      },
      "displayArtist": {
        "type": "string",
        "example": "M83"
      },
      "type": {
        "type": "string",
        "enum": [
          "Audio",
          "Video"
        ],
        "default": "Audio",
        "example": "Audio"
      },
      "version": {
        "type": "string",
        "example": "Album Version"
      },
      "isrc": {
        "type": "string",
        "pattern": "^[A-Z]{2}[A-Z0-9]{3}\\d{7}$",
        "example": "USRC17607839"
      },
      "iswc": {
        "type": "string",
        "pattern": "^T-\\d{9}-\\d$",
        "example": "T1234567890"
      },
      "mainGenre": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "Electronic",
          "Mental"
        ]
      },
      "subGenre": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "example": [
          "Synthwave"
        ]
      },
      "explicit": {
        "type": "boolean",
        "default": false
      },
      "id": {
        "type": "string",
        "format": "uuid"
      },
      "artists": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "type": {
              "type": "string",
              "enum": [
                "primary",
                "featuring"
              ]
            }
          }
        },
        "example": [
          {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "primary"
          }
        ]
      },
      "split": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "user": {
              "type": "string",
              "format": "uuid"
            },
            "share": {
              "type": "number",
              "minimum": 0,
              "maximum": 100
            }
          }
        },
        "example": [
          {
            "user": "550e8400-e29b-41d4-a716-446655440002",
            "share": 100
          }
        ]
      },
      "externalId": {
        "type": "string"
      },
      "contributors": {
        "type": "object",
        "properties": {
          "producers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "mixers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://server26-dot-royalti-project.uc.r.appspot.com/asset/example-id', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

​
id
string<uuid>
required

Asset ID

Response

Asset details retrieved successfully

​
success
boolean
Example:

true

​
message
string
​
data
object