ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIMessagesGet Conversation Media Gallery

Get Conversation Media Gallery

Fetches all historical media files, voice notes, photos, and document attachments exchanged within a customer conversation thread.

GET/api/v1/inbox/conversations/{id}/media

Query Parameters

4 parameters
{id}uuidrequired

Conversation UUID

typestringrequired

Filter by media category: all, image, video, audio, document (default: all)

limitnumberrequired

Number of media items to return (1 to 100, default: 50)

offsetnumberrequired

Pagination offset (default: 0)

Response Payload

200 OKapplication/json
successbooleanrequired

Whether request succeeded

data.media[].iduuidrequired

Message UUID

data.media[].typestringrequired

Media category (image, video, audio, document)

data.media[].directionstringrequired

Message direction (INBOUND or OUTBOUND)

data.media[].media_urlstringrequired

Direct or internal proxy media URL

data.media[].file_namestringrequired

File name

data.media[].created_atdatetimerequired

Message creation timestamp in IST (+05:30)

data.countsobjectrequired

Total counts per media category

Code Snippets & Examples

1curl -X GET "https://app.chatofy.in/api/v1/inbox/conversations/conv-8888-9999-aaaa-bbbbccccdddd/media?type=all" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Previous Endpoint
Batch Bulk Inbox Actions
Next Endpoint
Get Conversation Metadata & Attributes
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X GET "https://app.chatofy.in/api/v1/inbox/conversations/conv-8888-9999-aaaa-bbbbccccdddd/media?type=all" \
2 -H "Authorization: Bearer YOUR_API_KEY"
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "media": [
5 {
6 "id": "msg-7777-8888-9999-aaaabbbbcccc",
7 "conversation_id": "conv-8888-9999-aaaa-bbbbccccdddd",
8 "direction": "INBOUND",
9 "type": "image",
10 "media_url": "https://storage.chatofy.in/chat-media/payment-receipt.jpg",
11 "file_name": "payment-receipt.jpg",
12 "mime_type": "image/jpeg",
13 "file_size": 245760,
14 "caption": "Payment receipt",
15 "created_at": "2026-10-27T10:00:00+05:30"
16 },
17 {
18 "id": "msg-5555-6666-7777-888899990000",
19 "conversation_id": "conv-8888-9999-aaaa-bbbbccccdddd",
20 "direction": "OUTBOUND",
21 "type": "document",
22 "media_url": "https://storage.chatofy.in/chat-media/invoice-2026.pdf",
23 "file_name": "invoice-2026.pdf",
24 "mime_type": "application/pdf",
25 "file_size": 512000,
26 "caption": null,
27 "created_at": "2026-10-27T09:30:00+05:30"
28 }
29 ],
30 "pagination": {
31 "total": 2,
32 "limit": 50,
33 "offset": 0,
34 "has_more": false
35 },
36 "counts": {
37 "all": 2,
38 "image": 1,
39 "video": 0,
40 "document": 1,
41 "audio": 0
42 }
43 },
44 "message": "Conversation media retrieved successfully"
45}