Language

Radar Tasking & Archive - API

The API enables you to task an acquisition or search for archive imagery. The API is provided as an HTTP REST API and is using GeoJSON.


The basic workflow for placing an order is as follows.

  1. Task your acquisition or find suitable imagery in the archive
    1. For tasking: send description of acquisition to feasibility endpoint
    2. For archive: send description of imagery to catalogue endpoint
  2. Place an order
    1. Create a basket
    2. Add suitable acquisition or imagery to your basket
    3. Patch your basket by providing an order purpose
    4. Place your order by submitting the basket
  3. Monitor your order
  4. Download your data from the delivery endpoint

1.1 Find your future acquisition (for tasking)

When searching for possible acquisitions for tasking you must provide the following parameters.

aoiContains the AOI the feasibility is requested for
timeTime range for feasibility search
feasibilityLevel“complete” (recommended) or “simple”
sensorModeThe imaging/instrument/sensor mode to use for the acquisition
productTypeProduct type for the processing of the acquisition (Available: SSC, MGD, GEC, EEC)
orbitTypeRecommended for future acquisitions is rapid
Please see API Specification for further filter parameters

The endpoint to search for future (tasking) acquisitions:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/feasibility
REST verbPOST
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

The only mandatory parameter is a JSON payload following this schema:

{
  "aoi": {
    "type": "Polygon",
    "coordinates": [[[9.346, 47.788], [9.291, 47.644], [9.538, 47.592], [9.62, 47.75], [9.511, 47.802], [9.346, 47.788]]]
  },
  "time": {
    "from": "2022-10-14T13:28:03.569Z",
    "to": "2022-10-24T13:28:03.569Z"
  },
  "feasibilityLevel": "complete",
  "sensorMode": "SAR_SM_S",
  "productType": "EEC",
  "orbitType": "NRT"
}

Below is an example of the call:

curl -X POST \
  'https://sar.api.oneatlas.airbus.com/v1/sar/feasibility' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json'
  -d '{
  "aoi": {
    "type": "Polygon",
    "coordinates": [[[9.346, 47.788], [9.291, 47.644], [9.538, 47.592], [9.62, 47.75], [9.511, 47.802], [9.346, 47.788]]]
  },
  "time": {
    "from": "2022-10-14T13:28:03.569Z",
    "to": "2022-10-24T13:28:03.569Z"
  },
  "feasibilityLevel": "complete",
  "sensorMode": "SAR_SM_S",
  "productType": "EEC",
  "orbitType": "NRT"
}'

Each feature contains an itemId which is needed to add the acquisition to a basket for order placement. The response is shown below.



1.2 Find archive imagery

When searching for possible archive acquisitions there are no required parameters. However, at minimum you’ll probably want to specify at least an AOI and time range.

AOIContains the AOI for the search
timeTime range for the search

The endpoint to search for catalogue acquisitions:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/catalogue
REST verbPOST
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

The only and mandatory parameter is a JSON payload following this schema:

{
  "aoi": {
    "type": "Polygon",
    "coordinates": [
      [[9.346, 47.788], [9.291, 47.644], [9.538, 47.592], [9.62, 47.75], [9.511, 47.802], [9.346, 47.788]]
    ]
  },
  "time": {
    "from": "2021-10-14T13:28:03.569Z",
    "to": "2021-10-29T13:28:03.569Z"
  }
}

Below is an example of the call:

curl -X POST \
  'https://sar.api.oneatlas.airbus.com/v1/sar/catalogue' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json'
  -d '{
  "aoi": {
    "type": "Polygon",
    "coordinates": [
      [[9.346, 47.788], [9.291, 47.644], [9.538, 47.592], [9.62, 47.75], [9.511, 47.802], [9.346, 47.788]]
    ]
  },
  "time": {
    "from": "2021-10-14T13:28:03.569Z",
    "to": "2021-10-29T13:28:03.569Z"
  }
}'

Each feature contains an itemId which is needed to add the acquisition to a basket in order to order it. The response is shown below.



2. Place an order

Placing an order is a multiple step process of creating a basket, adding items to your basket, defining a purpose, and then submitting the basket.

2.1 Create a basket

Before you can add any items to a basket you will need a basketId. You can either use an existing basket (by retrieving all baskets) or create a new basket.

When creating a basket you can already add a purpose to it (which is needed in order to submit your basket). This can also be done at a later point.

The optional parameters to create a basket are the following:

purposeOne of the available values documented in the API Reference.
titleA name for the basket
customerReferenceA reference e.g. an ID you can use as a reference this basket

The endpoint to create a basket:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/baskets
REST verbPOST
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

Below is an example of the call:

curl -X POST \
  'https://sar.api.oneatlas.airbus.com/v1/sar/baskets' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json'
  -d '{"purpose": "Aerospace Industry Company"}'

The response will return the current values that have been assigned from creating your basket plus the basketId:

{
    "basketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "purpose": "Aerospace Industry Company"
}

2.2 Add items to your basket

When adding items to your basket you must provide the following parameter.

itemsList containing one or more tasking or archive itemIds
orderOptions.productTypeProduct type for the processing of the acquisition
orderOptions.resolutionVariantRadiometric or spatial enhancement
orderOptions.orbitTypeNear realtime acquisition, science processing, or rapid
orderOptions.mapProjectionProjection of the delivered product
orderOptions.gainAttenuationProcessor gain attenuation

The endpoint to add items to your basket:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/baskets/{basketId}/addItems
REST verbPOST
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

The only and mandatory parameter is a JSON payload following this schema:

{
    "items": [
        "23d5f214-1552-c3e0-78dd-436b2ab49ab7"
    ],
    "orderOptions": {
        "productType": "EEC",
        "resolutionVariant": "RE",
        "orbitType": "rapid",
        "mapProjection": "auto",
        "gainAttenuation": 0
    }
}

Below is an example of the call:

curl -X POST \
  'https://sar.api.oneatlas.airbus.com/v1/sar/baskets/3fa85f64-5717-4562-b3fc-2c963f66afa6/addItems' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json'
  -d '{
    "items": [
        "23d5f214-1552-c3e0-78dd-436b2ab49ab7"
    ],
    "orderOptions": {
        "productType": "EEC",
        "resolutionVariant": "RE",
        "orbitType": "rapid",
        "mapProjection": "auto",
        "gainAttenuation": 0
    }
}'

The response will contain a feature collection of the added items:



2.3 Patch your basket

If you haven’t set a purpose yet you must patch your basket to provide a purpose in order to submit it:

purposeOne of the available values documented in the API Reference.

The endpoint to patch your basket:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/baskets/{basketId}
REST verbPATCH
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

The only and mandatory parameter is a JSON payload following this schema:

{
  "purpose": "Space Agency"
}

Below is an example of the call:

curl -X PATCH \
  'https://sar.api.oneatlas.airbus.com/v1/sar/baskets/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json'
  -d '{"purpose": "Space Agency"}'

The response will return the current values that have been assigned from patching your basket:

{
    "purpose": "Space Agency",
    ...
}

2.4 Submit your basket

The final step in placing your order is to submit your basket. No additional payload is required for this request.


The endpoint to submit your basket:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/baskets/{basketId}/submit
REST verbPOST
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

Below is an example of the call:

curl -X POST \
  'https://sar.api.oneatlas.airbus.com/v1/sar/baskets/3fa85f64-5717-4562-b3fc-2c963f66afa6/submit' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \

The response will return order details including an estimated date the data will be available for download:



3. Check order status

Your order and its current status may be monitored.


The endpoint to check your order status:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/orders
REST verbGET
AuthenticationJWT Token, API Key, Access Token
API ReferenceSAR API

Below is an example of the call:

curl -X GET \
  'https://sar.api.oneatlas.airbus.com/v1/sar/orders/<order_id_OR_basket_id>' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \

The response will return order details including a current status for each item.

4. Download the data

Once your order is available you will receive a delivery notification by email containing information on how to download your data via FTPS or Aspera.

© Airbus Defence and Space 2022. All rights reserved. Privacy Policy | Legal Information

Contact Us