Get information about an uploaded file

Returns a JSON object with information about an uploaded file (file size, MIME type, metadata, etc).

Query parameters

pub_keystringRequired

Public key identifying an Uploadcare project your uploads will go to.

file_idstringRequired

File's unique ID.

Response

This endpoint returns an object.

uuidstring

File's unique ID.

file_idstring

Same as uuid

sizeinteger

File's size in bytes.

totalinteger

Same as size.

doneinteger

Same as size.

original_filenamestring

Original file of the uploaded file.

filenamestring

Sanitized original_filename.

mime_typestring

File's MIME-type.

image_infoany

video_infoany

is_imageboolean

True if the uploaded file is an image of a supported file format.

is_storedboolean

True if the file has been marked as stored.

is_readyboolean

True if the file is ready to be fetched from Uploadcare's CDN.

content_infoobjectOptional

Information about file content.

metadatamap from strings to anyOptional

Arbitrary metadata associated with a file.

s3_bucketstringOptional

Name of an AWS S3 bucket where the file is stored. Only available if you associate a Foreign Storage Bucket with your project.

Errors

1 curl -G https://upload.uploadcare.com/info/ \ 2 -d pub_key=caa9d29da887ee88ffe6 \ 3 -d file_id=67947755-1584-4e3f-902b-d4e2bf76a841

1 { 2 "uuid": "be3b4d5e-179d-460e-8a5d-69112ac86cbb", 3 "file_id": "be3b4d5e-179d-460e-8a5d-69112ac86cbb", 4 "size": 2667636, 5 "total": 2667636, 6 "done": 2667636, 7 "original_filename": "IMG-0412_123.JPG", 8 "filename": "IMG0412_123.JPG", 9 "mime_type": "image/jpeg", 10 "image_info": { 11 "color_mode": "RGB", 12 "orientation": 6, 13 "format": "JPEG", 14 "height": 4032, 15 "width": 3024, 16 "sequence": false, 17 "geo_location": { 18 "latitude": 55.62013611111111, 19 "longitude": 37.66299166666666 20 }, 21 "datetime_original": "2018-08-20T08:59:50", 22 "dpi": [ 23 72, 24 72 25 ] 26 }, 27 "video_info": { 28 "key": "value" 29 }, 30 "content_info": { 31 "mime": { 32 "mime": "image/jpeg", 33 "type": "image", 34 "subtype": "jpeg" 35 }, 36 "image": { 37 "color_mode": "RGB", 38 "orientation": 6, 39 "format": "JPEG", 40 "sequence": false, 41 "height": 4032, 42 "width": 3024, 43 "geo_location": { 44 "latitude": 55.62013611111111, 45 "longitude": 37.66299166666666 46 }, 47 "datetime_original": "2018-08-20T08:59:50Z", 48 "dpi": [ 49 72, 50 72 51 ] 52 }, 53 "video": { 54 "duration": 261827, 55 "format": "mp4", 56 "bitrate": 393, 57 "audio": [ 58 { 59 "bitrate": 78, 60 "codec": "aac", 61 "sample_rate": 44100, 62 "channels": 2 63 } 64 ], 65 "video": [ 66 { 67 "height": 360, 68 "width": 640, 69 "frame_rate": 30, 70 "bitrate": 315, 71 "codec": "h264" 72 } 73 ] 74 } 75 }, 76 "metadata": { 77 "subsystem": "uploader", 78 "pet": "cat" 79 }, 80 "is_image": true, 81 "is_stored": true, 82 "is_ready": true, 83 "s3_bucket": "custom-s3-bucket-name" 84 }

1	curl -G https://upload.uploadcare.com/info/ \
2	-d pub_key=caa9d29da887ee88ffe6 \
3	-d file_id=67947755-1584-4e3f-902b-d4e2bf76a841

1	{
2	"uuid": "be3b4d5e-179d-460e-8a5d-69112ac86cbb",
3	"file_id": "be3b4d5e-179d-460e-8a5d-69112ac86cbb",
4	"size": 2667636,
5	"total": 2667636,
6	"done": 2667636,
7	"original_filename": "IMG-0412_123.JPG",
8	"filename": "IMG0412_123.JPG",
9	"mime_type": "image/jpeg",
10	"image_info": {
11	"color_mode": "RGB",
12	"orientation": 6,
13	"format": "JPEG",
14	"height": 4032,
15	"width": 3024,
16	"sequence": false,
17	"geo_location": {
18	"latitude": 55.62013611111111,
19	"longitude": 37.66299166666666
20	},
21	"datetime_original": "2018-08-20T08:59:50",
22	"dpi": [
23	72,
24	72
25	]
26	},
27	"video_info": {
28	"key": "value"
29	},
30	"content_info": {
31	"mime": {
32	"mime": "image/jpeg",
33	"type": "image",
34	"subtype": "jpeg"
35	},
36	"image": {
37	"color_mode": "RGB",
38	"orientation": 6,
39	"format": "JPEG",
40	"sequence": false,
41	"height": 4032,
42	"width": 3024,
43	"geo_location": {
44	"latitude": 55.62013611111111,
45	"longitude": 37.66299166666666
46	},
47	"datetime_original": "2018-08-20T08:59:50Z",
48	"dpi": [
49	72,
50	72
51	]
52	},
53	"video": {
54	"duration": 261827,
55	"format": "mp4",
56	"bitrate": 393,
57	"audio": [
58	{
59	"bitrate": 78,
60	"codec": "aac",
61	"sample_rate": 44100,
62	"channels": 2
63	}
64	],
65	"video": [
66	{
67	"height": 360,
68	"width": 640,
69	"frame_rate": 30,
70	"bitrate": 315,
71	"codec": "h264"
72	}
73	]
74	}
75	},
76	"metadata": {
77	"subsystem": "uploader",
78	"pet": "cat"
79	},
80	"is_image": true,
81	"is_stored": true,
82	"is_ready": true,
83	"s3_bucket": "custom-s3-bucket-name"
84	}