REST: Plan API

Have more questions? Submit a request
Combined list of maps and flight plans
This API is usually the starting point for finding exports, tile templates and taking measurements programmatically. It provides information about all plans or a particular plan.

First, you will need an API Key

List all plans

In order to list all plans available in your account, send a GET request to /v2/plans.
This will fetch the first page of 50 plans. To request more, see API Pagination

GET /v2/plans

Returns JSON - List of all plans and associated metadata

curl "https://public-api.dronedeploy.com/v2/plans?api_key={api_key}"
[  
  {
    "log": "EXAMPLE_000002",
    "id": "5605c0e5752afc005a000004",
    "location": {
      "lat": 35.92596388888889,
      "lng": -96.74810972222222
    },
    "image_count": 66,
    "date_creation": 1377012456330,
    "latest_started_map": {
      "user_status": "Complete"
    },
    "name": "Construction Example"
  },
  {
    "log": "EXAMPLE_000001",
    "id": "56048e63752afc0058000001",
    "location": {
      "lat": 48.60367083333334,
      "lng": -97.21722638888889
    },
    "image_count": 301,
    "date_creation": 1372605078006,
    "latest_started_map": {
      "user_status": "Complete"
    },
    "name": "Agriculture Example"
  }
]

Get all data for a specific plan

To get all data for a specific plan in your account.

GET /v2/plans/<planid>

  • The plan_id can be obtained by listing all plans (above)

Returns JSON - Detailed plan metadata and links

curl "https://public-api.dronedeploy.com/v2/plans/5605c0e5752afc005a000004?api_key={api_key}"
{
  "log": "EXAMPLE_000002",
  "id": "5605c0e5752afc005a000004",
  "location": {
    "lat": 35.92596388888889,
    "lng": -96.74810972222222
  },
  "image_count": 66,
  "date_creation": 1377012456330,
  "latest_started_map": {
    "user_status": "Complete"
  },
  "name": "Construction Example"
}

Please go to our API explorer page and our developer page for our new, more robust GraphQL based APIs.

Articles in this section

Was this article helpful?
0 out of 0 found this helpful