Download OpenAPI specification:Download
Welcome to the Inflights API's reference documentation.
The Inflights API allows you to integrate with our platform, so you can allow your clients to order drone data anywhere in the world through a seamlessly integrated experience.
You can request API access via info@inflights.com
The API supports operations similar to the ones a customer would go through if they were to order a flight via Inflights' Quote tool:
Webhooks can be used to retrieve updates about various events related to e.g. flights.
Currently the following events are supported:
The webhooks will POST a JSON payload to an endpoint of your choosing, and will retry until the endpoint returns a successful status in the 2xx range (for example 200 OK or 201 Created).
All webhook events will have an "event_name" and "data" property. Currently, all events relate to flights, so their "data" properly will contain the flight info in the same format like you would get from the API endpoints.
Here is an example of the flight_created
event:
{
"event_name": "flight_created",
"data": {
"flight": {
"id": 123,
"regulation_status": "authorised_to_fly",
"quote_accepted_at": "2021-03-23T09:00:00.000Z",
"cancelled_at": null,
"completed_at": null,
"price": 1234.5,
"scheduled_flight_date": null,
"backup_scheduled_flight_date": null,
"pilot_confirmed": false
}
}
}
All endpoints require authentication via the 'Basic' HTTP Authentication scheme
Security Scheme Type | HTTP |
---|---|
HTTP Authorization Scheme | basic |
This endpoint returns all flights associated with the currently used API credentials.
{- "flights": [
- {
- "id": "AB123",
- "regulation_status": "authorised_to_fly",
- "pricing": {
- "total_price": 900,
- "total_price_before_discount": 1000,
- "discount": 100,
- "currency_code": "EUR"
}, - "quote_accepted_at": "2020-08-24T14:15:22Z",
- "cancelled_at": null,
- "completed_at": "2020-10-01T12:00:00Z",
- "scheduled_flight_date": "2020-09-23",
- "backup_scheduled_flight_date": "2020-09-24",
- "pilot_confirmed": true,
- "product": {
- "id": 1,
- "name": "Drone Mapping"
}
}
], - "pagination": {
- "current_page": 1,
- "per_page": 50,
- "total_pages": 1,
- "total_items": 1
}
}
This endpoint creates a quote to fly over a specific area and have a specific product delivered. After this API has been called, the quote still needs to be accepted before we will proceed to scheduling and executing the flight.
product_id | integer The identifier of the selected product. |
object (flight_areas) The area(s) of interest for the flight in GeoJSON format. | |
object (location) Information about the location which a pilot can use to organize the flight (e.g. contact someone at the location). |
{- "product_id": 0,
- "areas": {
- "type": "Feature",
- "properties": { },
- "geometry": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Polygon",
- "coordinates": [
- [
- [
- 4.40409915351867,
- 51.229374467104414
], - [
- 4.405798746109015,
- 51.22938790398638
], - [
- 4.406034780502326,
- 51.2280597489213
], - [
- 4.40409915351867,
- 51.22801943710027
], - [
- 4.40409915351867,
- 51.229374467104414
]
]
]
}
]
}
}, - "location": {
- "latitude": 50.85,
- "longitude": 4.38
}
}
{- "flight": {
- "id": "AB123",
- "regulation_status": "authorised_to_fly",
- "pricing": {
- "total_price": 900,
- "total_price_before_discount": 1000,
- "discount": 100,
- "currency_code": "EUR"
}, - "quote_accepted_at": "2020-08-24T14:15:22Z",
- "cancelled_at": null,
- "completed_at": "2020-10-01T12:00:00Z",
- "scheduled_flight_date": "2020-09-23",
- "backup_scheduled_flight_date": "2020-09-24",
- "pilot_confirmed": true,
- "product": {
- "id": 1,
- "name": "Drone Mapping"
}
}
}
This endpoint previews the response you would get if you created a flight via POST /flights
.
product_ids | Array of integers The identifier(s) of the products which you want to preview. |
object (flight_areas) The area(s) of interest for the flight in GeoJSON format. | |
object (location) Information about the location which a pilot can use to organize the flight (e.g. contact someone at the location). |
{- "product_ids": [
- 1
], - "areas": {
- "type": "Feature",
- "properties": { },
- "geometry": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Polygon",
- "coordinates": [
- [
- [
- 4.40409915351867,
- 51.229374467104414
], - [
- 4.405798746109015,
- 51.22938790398638
], - [
- 4.406034780502326,
- 51.2280597489213
], - [
- 4.40409915351867,
- 51.22801943710027
], - [
- 4.40409915351867,
- 51.229374467104414
]
]
]
}
]
}
}, - "location": {
- "latitude": 50.85,
- "longitude": 4.38
}
}
{- "flights": [
- {
- "id": "AB123",
- "regulation_status": "authorised_to_fly",
- "pricing": {
- "total_price": 900,
- "total_price_before_discount": 1000,
- "discount": 100,
- "currency_code": "EUR"
}, - "quote_accepted_at": "2020-08-24T14:15:22Z",
- "cancelled_at": null,
- "completed_at": "2020-10-01T12:00:00Z",
- "scheduled_flight_date": "2020-09-23",
- "backup_scheduled_flight_date": "2020-09-24",
- "pilot_confirmed": true,
- "product": {
- "id": 1,
- "name": "Drone Mapping"
}
}
]
}
Returns information associated with the flight.
flight_id required | string Example: AB123 The ID of the flight |
{- "flight": {
- "id": "AB123",
- "regulation_status": "authorised_to_fly",
- "pricing": {
- "total_price": 900,
- "total_price_before_discount": 1000,
- "discount": 100,
- "currency_code": "EUR"
}, - "quote_accepted_at": "2020-08-24T14:15:22Z",
- "cancelled_at": null,
- "completed_at": "2020-10-01T12:00:00Z",
- "scheduled_flight_date": "2020-09-23",
- "backup_scheduled_flight_date": "2020-09-24",
- "pilot_confirmed": true,
- "product": {
- "id": 1,
- "name": "Drone Mapping"
}, - "area": {
- "geom_of_interest": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Polygon",
- "coordinates": [
- [
- [
- 4.40409915351867,
- 51.229374467104414
], - [
- 4.405798746109015,
- 51.22938790398638
], - [
- 4.406034780502326,
- 51.2280597489213
], - [
- 4.40409915351867,
- 51.22801943710027
], - [
- 4.40409915351867,
- 51.229374467104414
]
]
]
}
]
}, - "geom_of_flight": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Polygon",
- "coordinates": [
- [
- [
- 4.40409915351867,
- 51.229374467104414
], - [
- 4.405798746109015,
- 51.22938790398638
], - [
- 4.406034780502326,
- 51.2280597489213
], - [
- 4.40409915351867,
- 51.22801943710027
], - [
- 4.40409915351867,
- 51.229374467104414
]
]
]
}
]
}
}, - "areas": {
- "type": "Feature",
- "properties": { },
- "geometry": {
- "type": "GeometryCollection",
- "geometries": [
- {
- "type": "Polygon",
- "coordinates": [
- [
- [
- 4.40409915351867,
- 51.229374467104414
], - [
- 4.405798746109015,
- 51.22938790398638
], - [
- 4.406034780502326,
- 51.2280597489213
], - [
- 4.40409915351867,
- 51.22801943710027
], - [
- 4.40409915351867,
- 51.229374467104414
]
]
]
}
]
}
}
}
}
Returns the files associated with this flight (raw pictures, point clouds, CAD models, etc.).
These files are guaranteed to be available once the flight has been marked as completed and has a completed_at
timestamp.
flight_id required | string Example: AB123 The ID of the flight |
{- "deliverables": [
- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "title": "Point Cloud",
- "filename": "point_cloud.las",
- "deliverable_type": {
- "name": "3D Point Cloud",
- "uploaded_by_pilot": false
}
}
]
}
Returns a GeoJSON response indicating the coverage of our pilot network.
{- "type": "FeatureCollection",
- "features": [
- {
- "type": "Feature",
- "properties": {
- "subset": "lidar"
}, - "geometry": {
- "type": "MultiPolygon",
- "coordinates": [
- [
- [
- [
- 4.40409915351867,
- 51.229374467104414
], - [
- 4.405798746109015,
- 51.22938790398638
], - [
- 4.406034780502326,
- 51.2280597489213
], - [
- 4.40409915351867,
- 51.22801943710027
], - [
- 4.40409915351867,
- 51.229374467104414
]
]
]
]
}
}
]
}
{- "products": [
- {
- "id": 35,
- "name": "Terrain - Drone mapping",
- "subtitle": "Absolute accuracy 2cm",
- "description": "3D measurements and pictures for the as-is situation. Deliverables include 3D point cloud, 3D mesh and 2D orthomosaic.",
- "product_type": "terrain",
- "auto_pricing_enabled": true,
- "max_area_in_ha_for_auto_price": 300
}
]
}