The REST Camera File API allows you to programmatically access and manage camera files within your DroneDeploy projects. This tool streamlines workflows for developers who need to integrate raw imagery data into third-party applications or internal databases.
This API provides a reliable method to retrieve metadata and download links for individual images captured during a flight. By using this interface, you can automate the extraction of high-resolution files without manual exports.
Availability
The REST Camera File API is available for Enterprise and Advanced DroneDeploy subscriptions.
Access requires a valid API Key generated from your Account Settings.
The Camera File API can be used to fetch information about camera position, sensors, reference and transformation. First, you will need an API Key
Get Camera Information
GET /v1/camfile/<session_or_plan_id>
Returns JSON - Information from camera file
curl "https://public-api.dronedeploy.com/v1/camfile/580fd790d5d264a5d8515a73?api_key={api_key}"
{
"sensors": [
{
"id": 0,
"label": "DJI - FC300X",
"type": "frame",
"model": 2,
"pixel_width": 0.01263496,
"pixel_height": 0.01263496,
"focal_length": 3.610000134,
"resolution": {
"width": 500,
"height": 375
},
"calibration": {
"fx": 282.7244117,
"fy": 282.7244117,
"cx": 248.238593,
"cy": 186.1479231,
"k1": -0.003484606466,
"k2": 0.006244951394,
"k3": 0.006887074802,
"p1": -0.001797974714,
"p2": -0.001902062335
}
}
],
"cameras": [
{
"id": 0,
"sensor_id": 0,
"enabled": true,
"image": "9f322a0d11e77a95288f152a3e48fc21.jpg",
"reference": {
"x": -122.4073757,
"y": 37.771785,
"z": 51.8,
"yaw": 3.14159,
"pitch": -2.18505e-17,
"roll": -2.17293,
"enabled": 1.0
},
"transform": "-0.5277127357 -0.8448213234 -0.08829609283 4.71166813 -0.8424134819 0.5338493019 -0.07310573368 -5.654401336 0.1088980902 0.03580299228 -0.9934079483 0.7155290009 0 0 0 1",
"depth": 54.35087585
},
{
"id": 1,
"sensor_id": 0,
"enabled": true,
"image": "dce9c93c9835661e6968f125fb5cd537.jpg",
"reference": {
"x": -122.4072513,
"y": 37.77171964,
"z": 51.6,
"yaw": 3.14159,
"pitch": -2.20594e-17,
"roll": -2.17468,
"enabled": 1.0
},
"transform": "-0.5367118941 -0.8388475673 -0.09096758481 4.063725897 -0.8371113237 0.5428888279 -0.06720381163 5.598462595 0.1057590394 0.0400809103 -0.9935836886 0.1463723952 0 0 0 1",
"depth": 53.85559082
},
{
"id": 2,
"sensor_id": 0,
"enabled": true,
"image": "a1b90a0230f6850ee7c476577e90d732.jpg",
"reference": {
"x": -122.4070509,
"y": 37.77161853,
"z": 51.5,
"yaw": -3.1406,
"pitch": -0.00143837,
"roll": -2.17294,
"enabled": 1.0
},
"transform": "-0.5394024045 -0.83669226 -0.09482145371 3.4221742 -0.8356288769 0.5457636812 -0.06218025734 26.04479669 0.1037758457 0.04569536454 -0.9935504554 -0.9486739827 0 0 0 1",
"depth": 53.04673386
},
{
"id": 3,
"sensor_id": 0,
"enabled": true,
"image": "158232b091f352d585f7c62d5943f5e0.jpg",
"reference": {
"x": -122.406963,
"y": 37.77156953,
"z": 51.5,
"yaw": 3.14159,
"pitch": -2.01771e-17,
"roll": -2.15897,
"enabled": 1.0
},
"transform": "-0.5278425188 -0.84432699 -0.09216403526 1.628806522 -0.8427750068 0.5341364041 -0.06654765015 39.65568262 0.1054161435 0.04254686617 -0.9935175896 -1.641433452 0 0 0 1",
"depth": 52.65577698
},
{
"id": 4,
"sensor_id": 0,
"enabled": true,
"image": "2021cc17c8a75ecc77725d34a9e7a960.jpg",
"reference": {
"x": -122.4069086,
"y": 37.77154194,
"z": 51.1,
"yaw": 3.14159,
"pitch": -1.55561e-17,
"roll": -2.12058,
"enabled": 1.0
},
"transform": "-0.499769114 -0.86235182 -0.08111825451 0.5466809341 -0.8599955396 0.5051844097 -0.07208594937 42.05779296 0.1031431272 0.03373500601 -0.9940942836 -3.984763606 0 0 0 1",
"depth": 50.35983658
},
{
"id": 5,
"sensor_id": 0,
"enabled": true,
"image": "58404edd65e98ab5167889aab0cfb177.jpg",
"reference": {
"x": -122.4069224,
"y": 37.77156236,
"z": 48.3,
"yaw": 3.14159,
"pitch": 8.13306e-17,
"roll": 0.417134,
"enabled": 1.0
},
"transform": "0.9480300453 0.3055834688 0.08864410143 -27.91278405 0.3070222455 -0.9516983897 -0.002741504143 -26.92302973 0.08352469024 0.02981473937 -0.9960595903 -4.258062803 0 0 0 1",
"depth": 49.56679916
}
],
"transform": {
"rotation": "0.8442592077 0.3282693645 -0.4236338213 -0.5359350615 0.5171231619 -0.6673509161 4.665071145e-17 0.7904573738 0.612517053",
"translation": "-2705415.5851 -4261844.73136 3885478.07418",
"scale": "1",
"origin": "-122.407347228,37.7717256521,50.7386885723"
}
Key Features
Direct Access: Skip the manual export process and pull data directly into your stack.
Metadata Integration: Retrieve EXIF data, including GPS coordinates, altitude and timestamps.
Scalability: Handle thousands of images across multiple projects with automated scripts.
Limitations
The API does not support bulk downloading in a single ZIP format; you must call each file URL individually.
Rate limits apply to prevent service degradation. Contact the Support team for specific threshold details.
Frequently Asked Questions (FAQs)
Q: Does the API support video files? A: No. The REST Camera File API supports JPG and TIFF image formats only.
Q: Can I use this to upload images? A: This specific endpoint is for retrieval only. To upload data, please refer to our Data Upload API documentation.
V2.2