Get Media document by UUID

Get Media by UUID

Retrieve a media document using its unique identifier (UUID).

---

Endpoint

GET /api/v2/media/{uuid}

---

Description

This API fetches the details of a specific media item (image or video) using its UUID. It returns metadata, tags, media type, creation details, and the public media URL.

---

Base URL

Environment	URL
Release Candidate (RC)	https://sdk-mobile-api-rc.truvideo.com
Production	https://sdk-mobile-api.truvideo.com

---

Authorization

This endpoint requires Bearer Token authentication.

• Generate the access token using: [SDK Mobile] – Generate an API Token

Header

Authorization: Bearer {YOUR-ACCESS-TOKEN}

---

Path Parameters

Parameter	Type	Required	Description
uuid	String (UUID)	Yes	Unique identifier of the media item

---

Curl Example

curl --location --request GET '{{BASE-URL}}/api/v2/media/{{uuid}}' \
--header 'Authorization: Bearer {{YOUR-ACCESS-TOKEN}}'

---

Success Response

HTTP Status: 200 OK

{
  "id": "c1f0a8c2-1e2b-4c3f-b9c7-3b9a4c8a1f2d",
  "url": "http://example.com/archivo.mp4",
  "metadata": {
    "requestedBy": "Service Department",
    "campaign": "spring-diagnostics",
    "location": "Service Bay 4"
  },
  "tags": {
    "tag1": "tag1",
    "tag2": "tag2"
  },
  "type": "VIDEO",
  "createdDate": "2024-10-09T12:47:17Z",
  "title": "Example title",
  "subAccountId": "00000000-0000-0000-0000-000000000000",
  "includeInReport": true
}

---

Response Fields

Field	Type	Description
id	UUID	Unique identifier of the media
url	String	Publicly accessible media URL
metadata	Object	Custom metadata provided during upload
tags	Object	Key-value tags associated with the media
type	String	Media type (VIDEO, IMAGE)
createdDate	ISO 8601 Date	Media creation timestamp
title	String	Media title
subAccountId	UUID	Associated sub-account ID
includeInReport	Boolean	Indicates if media is included in reports

---

Error Responses

HTTP Code	Description
401 Unauthorized	Invalid or missing access token
404 Not Found	Media not found for the given UUID
500 Internal Server Error	Server-side error

---

Notes

• Ensure the UUID exists and belongs to the authenticated account.

• The media URL may be time-limited or protected based on configuration.

• Metadata and tags are optional and may be empty.

---