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. Add suitable acquisition or imagery to your shopcart
    2. Patch your shopcart by providing an order purpose
    3. Place your order by submitting the shopcart
  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
feasibilityLevelMust have a value of “complete”
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) acsquisitions:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/feasibility
REST verbPOST
AuthenticationJWT 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 the shopcart for order placement. The response is shown below.

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            9.9538131,
                            47.4980337
                        ],
                        [
                            9.9526947,
                            47.5021113
                        ],
                        [
                            9.9162488,
                            47.6270696
                        ],
                        [
                            9.8795075,
                            47.7519972
                        ],
                        [
                            9.8423837,
                            47.8768735
                        ],
                        [
                            9.8066473,
                            47.9977132
                        ],
                        [
                            9.3889616,
                            47.9406197
                        ],
                        [
                            9.4256935,
                            47.819838
                        ],
                        [
                            9.4648433,
                            47.6951461
                        ],
                        [
                            9.502884,
                            47.5703346
                        ],
                        [
                            9.5385999,
                            47.4451919
                        ],
                        [
                            9.5398951,
                            47.4411314
                        ],
                        [
                            9.9538131,
                            47.4980337
                        ]
                    ]
                ]
            },
            "properties": {
                "acquisitionId": "TSX-1_SM_S_strip_004R_85134_A13768051_8000",
                "startTime": "2022-10-21T16:59:42.136Z",
                "stopTime": "2022-10-21T16:59:50.136Z",
                "submissionDeadline": "2022-10-20T21:30:00Z",
                "expiry": "2022-07-04T15:56:31Z",
                "estimatedDownloadAvailability": "2022-10-21T17:00:00Z",
                "sensorMode": "SAR_SM_S",
                "polarizationChannels": "HH",
                "beamId": "strip_004R",
                "pathDirection": "ascending",
                "lookDirection": "R",
                "incidenceAngle": {
                    "minimum": 22.29,
                    "maximum": 25.56
                },
                "relativeOrbit": 131,
                "absoluteOrbit": 85134,
                "priority": "standard",
                "mission": "TSX",
                "satellite": "TSX-1",
                "productType": "EEC",
                "orbitType": "NRT",
                "itemType": "future",
                "acquisitionOnly": false,
                "itemId": "57c91769-91e1-2f7e-2883-50a78a10b62c",
                "lastUpdateTime": "2022-06-27T15:56:31Z",
                "status": "feasible",
                "conflicts": {
                    "status": "none"
                },
                "sensitivity": {
                    "status": "potential",
                    "missingParameters": [
                        "resolutionVariant"
                    ]
                }
            }
        }
    ]
}

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 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 the shopcart in order to order it. The response is shown below.

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            160.0763526,
                            56.984591
                        ],
                        [
                            160.0631124,
                            57.0308927
                        ],
                        [
                            159.928554,
                            57.0171956
                        ],
                        [
                            159.9426206,
                            56.9709652
                        ],
                        [
                            160.0763526,
                            56.984591
                        ]
                    ]
                ]
            },
            "properties": {
                "itemId": "23d5f214-1552-c3e0-78dd-436b2ab49ab7",
                "satellite": "TSX-1",
                "acquisitionId": "TSX-1_HS300_S_spot_047R_2660_A14700092_740",
                "startTime": "2007-12-07T06:58:36.665000Z",
                "stopTime": "2007-12-07T06:58:37.405000Z",
                "polarizationChannels": "HH",
                "beamId": "spot_047",
                "pathDirection": "ascending",
                "lookDirection": "R",
                "incidenceAngle": {
                    "minimum": 38.05,
                    "maximum": 38.75
                },
                "relativeOrbit": 155,
                "absoluteOrbit": 2660,
                "status": "availableInArchive",
                "itemType": "catalogue",
                "catalogueTime": "2022-02-12T17:41:39.855601Z",
                "antennaMode": "SRA",
                "datastackCount": 1,
                "centerTime": "2007-12-07T06:58:37.035000Z",
                "lastUpdateTime": "2022-06-27T16:54:06Z",
                "mission": "TSX",
                "sensorMode": "SAR_HS_S_300",
                "quality": "AUTO_APPROVED",
                "downlinkTime": "2007-12-07T07:17:32.000000Z",
                "resolution": {
                    "minimum": 1.0,
                    "maximum": 3.5
                }
            }
        }
    ]
}

2. Place an order

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

2.1 Add items to your shopcart

When adding items to your shopcart 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 shopcart:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/shopcart/addItems
REST verbPOST
AuthenticationJWT 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/shopcart/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:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            160.0763526,
                            56.984591
                        ],
                        [
                            160.0631124,
                            57.0308927
                        ],
                        [
                            159.928554,
                            57.0171956
                        ],
                        [
                            159.9426206,
                            56.9709652
                        ],
                        [
                            160.0763526,
                            56.984591
                        ]
                    ]
                ]
            },
            "properties": {
                "itemId": "23d5f214-1552-c3e0-78dd-436b2ab49ab7",
                "orderItemId": "1",
                "mission": "TSX",
                "acquisitionId": "TSX-1_HS300_S_spot_047R_2660_A14700092_740",
                "startTime": "2007-12-07T06:58:36.665Z",
                "stopTime": "2007-12-07T06:58:37.405Z",
                "polarizationChannels": "HH",
                "beamId": "spot_047",
                "pathDirection": "ascending",
                "lookDirection": "R",
                "incidenceAngle": {
                    "minimum": 38.05,
                    "maximum": 38.75
                },
                "productType": "EEC",
                "resolutionVariant": "RE",
                "orbitType": "rapid",
                "mapProjection": "auto",
                "gainAttenuation": 0,
                "relativeOrbit": 155,
                "absoluteOrbit": 2660,
                "status": "availableInArchive",
                "itemType": "catalogue",
                "price": {
                    "total": 2812.5,
                    "currency": "USD",
                    "unitPrice": 2812.5,
                    "quantity": 1.0,
                    "final": true
                },
                "lastUpdateTime": "2022-07-05T15:46:38Z",
                "sensorMode": "SAR_HS_S_300"
            }
        }
    ]
}

2.2 Patch your shopcart

Your shopcart must be patched to provide a purpose.

purposeOne of the available values documented in the API Reference.

The endpoint to patch your shopcart:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/shopcart
REST verbPATCH
AuthenticationJWT Token
API ReferenceSAR API

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

{
  "purpose": "Aerospace Industry Company"
}

Below is an example of the call:

curl -X PATCH \
  'https://sar.api.oneatlas.airbus.com/v1/sar/shopcart' \
  -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 patching your shopcart:

{
    "purpose": "Aerospace Industry Company"
}

2.3 Submit your shopcart

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


The endpoint to submit your shopcart:

API Endpointhttps://sar.api.oneatlas.airbus.com/v1/sar/shopcart/submit
REST verbPOST
AuthenticationJWT Token
API ReferenceSAR API

Below is an example of the call:

curl -X POST \
  'https://sar.api.oneatlas.airbus.com/v1/sar/shopcart/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:

{
    "orderId": "135758",
    "purpose": "Aerospace Industry Company",
    "items": {
        "type": "FeatureCollection",
        "features": [
            {
                "type": "Feature",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                160.0763526,
                                56.984591
                            ],
                            [
                                160.0631124,
                                57.0308927
                            ],
                            [
                                159.928554,
                                57.0171956
                            ],
                            [
                                159.9426206,
                                56.9709652
                            ],
                            [
                                160.0763526,
                                56.984591
                            ]
                        ]
                    ]
                },
                "properties": {
                    "itemId": "23d5f214-1552-c3e0-78dd-436b2ab49ab7",
                    "orderItemId": "000135758_0001",
                    "mission": "TSX",
                    "acquisitionId": "TSX-1_HS300_S_spot_047R_2660_A14700092_740",
                    "startTime": "2007-12-07T06:58:36.665Z",
                    "stopTime": "2007-12-07T06:58:37.405Z",
                    "polarizationChannels": "HH",
                    "beamId": "spot_047",
                    "pathDirection": "ascending",
                    "lookDirection": "R",
                    "incidenceAngle": {
                        "minimum": 38.05,
                        "maximum": 38.75
                    },
                    "productType": "EEC",
                    "resolutionVariant": "RE",
                    "orbitType": "rapid",
                    "mapProjection": "auto",
                    "gainAttenuation": 0,
                    "relativeOrbit": 155,
                    "absoluteOrbit": 2660,
                    "status": "submitted",
                    "itemType": "catalogue",
                    "price": {
                        "final": true,
                        "total": 2812.5,
                        "currency": "USD",
                        "quantity": 1.0,
                        "unitPrice": 2812.5
                    },
                    "lastUpdateTime": "2022-07-05T15:56:44Z",
                    "sensorMode": "SAR_HS_S_300",
                    "estimatedDownloadAvailability": "2022-07-05T17:56:18.373Z",
                    "orderSubmissionTime": "2022-07-05T15:56:18.373Z"
                }
            }
        ]
    }
}

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 ReferenceSAR API

Below is an example of the call:

curl -X GET \
  'https://sar.api.oneatlas.airbus.com/v1/sar/orders/<order_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.

Contact Us