Skip to main content
GET
/
v1
/
media
/
{id}
cURL
curl --request GET \
  --url https://api.buildwithchirp.com/v1/media/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "fileName": "<string>",
  "mimeType": "<string>",
  "fileSize": 123,
  "mediaType": "image",
  "url": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

App API key (format: sk_live_app_* or sk_test_app_*) for app-level operations

Path Parameters

​
id
string
required

Media ID

Response

Media details

​
id
string
required

Unique media ID

​
fileName
string
required

Original file name

​
mimeType
string
required

MIME type of the file

​
fileSize
number
required

File size in bytes

​
mediaType
enum<string>
required

Type of media

Available options:
image,
video,
audio,
document,
sticker
​
url
string<uri>
required

Presigned URL for downloading (expires in 1 hour)

​
expiresAt
string<date-time>
required

When the media will be deleted

​
createdAt
string<date-time>
required

When the media was uploaded