Language

Order an Individual Product

Ordering an individual product will provide you a chance to select an OneAtlas data Living Library image, clip it to your AOI, process it using your custom parameters and get delivered in your workspace. Once delivered, you will be able to download or stream the resulting product.

Note: When ordering a product your AOI must be minimum **0.1km² for all products.

When retrieving the price or ordering a product there will be parameters that you need to specify for the API to calculate the correct price. The same parameters will need to be specified when you place your order. This section will guide you through the available parameters for our Ordering API.
As Living Library offers several consumption modes, you will have to define the order kind you want to use:

Order kindConsumption modeDescriptionSensors
order.data.productkm²Consumption based on km²SPOT and Pléiades and Pléiades Neo
order.data.productTiles - This mode will be abandoned soonConsumption based on number of tiles viewedSPOT and Pléiades only
order.data.gb.productGB (GigaBytes) - This mode will be abandoned soonConsumption based on processed GBSPOT and Pléiades only

Available product types are:

Product typeDescriptionSensors
bundleone Panchromatic image + the Multispectral bands delivered separatelySPOT and Pléiades
pansharpenedmerging the Panchromatic with the full set of colour bandsSPOT and Pléiades
panchromaticone Panchromatic imageSPOT and Pléiades
multiSpectralthe Multispectral (Blue, Green, Red and Near Infrared) bandsSPOT and Pléiades
bundle-fsone Panchromatic image + the Multispectral bands delivered separatelyPléiades Neo
pansharpened-fsmerging the Panchromatic with the full set of colour bandsPléiades Neo

Available image format are:

Image FormatDescription
image/jp2The format of the delivered image will be JPEG 2000
image/geotiffThe format of the delivered image will be Geotiff

Available EPSG code are:

Image ProjectionDescription
EPSG:4326Geodetic coordinate system for World using Uses simple Equirectangular projection
EPSG:326[01-60]WGS 84 north zones
EPSG:327[01-60]WGS 84 south zones

Available radiometric processing types are:

Radiometric ProcessingDescriptionSensors
BASIC16No radiometric processing applied.SPOT and Pléiades only
REFLECTANCERadiometrically corrected images (sensor calibration and systematic atmospheric effects)SPOT and Pléiades and Pléiades Neo
DISPLAYOptimized for visual rendering. 8-bit pixel only.SPOT and Pléiades and Pléiades Neo

Calculate Price for an Individual Product

When calculating the price of an individual product you must specify certain parameters. The JSON structure to provide has the form:

{
    "kind": "order.data.product",
    "products": [
        {
            "crsCode": "urn:ogc:def:crs:EPSG::4326",
            "productType": "pansharpened",
            "radiometricProcessing": "DISPLAY",
            "aoi": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            1.4089965820312502,
                            43.59829500262717
                        ],
                        [
                            1.4089965820312502,
                            43.63408731864001
                        ],
                        [
                            1.5078735351562496,
                            43.63408731864001
                        ],
                        [
                            1.5078735351562496,
                            43.59829500262717
                        ],
                        [
                            1.4089965820312502,
                            43.59829500262717
                        ]
                    ]
                ]
            },
            "id": "3f33d1b8-ec54-433b-9808-107cee523637",
            "imageFormat": "image/jp2"
        }
    ]
}

To calculate the price of a product the following endpoint must be used:

API Endpoint/api/v1/prices
REST verbPOST
AuthenticationJWT Token
API ReferenceOrder API

Below is an example of a call:

curl -X POST \
  https://data.api.oneatlas.airbus.com/api/v1/prices \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -d '{
  "kind": "order.data.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "d42de348-110b-4ed6-a597-755867b3ee54",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [1.4089965820312502, 43.59829500262717],
            [1.4089965820312502, 43.63408731864001],
            [1.5078735351562496, 43.63408731864001],
            [1.5078735351562496, 43.59829500262717],
            [1.4089965820312502, 43.59829500262717]
          ]
        ]
      }
    }
  ]
}'
var data = JSON.stringify({
  "kind": "order.data.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "d42de348-110b-4ed6-a597-755867b3ee54",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [1.4089965820312502, 43.59829500262717],
            [1.4089965820312502, 43.63408731864001],
            [1.5078735351562496, 43.63408731864001],
            [1.5078735351562496, 43.59829500262717],
            [1.4089965820312502, 43.59829500262717]
          ]
        ]
      }
    }
  ]
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://data.api.oneatlas.airbus.com/api/v1/prices");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);
import requests

headers = {
    'Authorization': token,
    'Content-Type': "application/json",
    'Cache-Control': "no-cache",
    }
url = "https://data.api.oneatlas.airbus.com/api/v1/prices"
payload = {
  "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "d42de348-110b-4ed6-a597-755867b3ee54",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [1.4089965820312502, 43.59829500262717],
            [1.4089965820312502, 43.63408731864001],
            [1.5078735351562496, 43.63408731864001],
            [1.5078735351562496, 43.59829500262717],
            [1.4089965820312502, 43.59829500262717]
          ]
        ]
      }
    }
  ]
}
response = requests.request("POST", url, json=payload,headers=headers)

Note: Your kind must be order.data.product if you have a GB subscription (soon to be deprecated), or order.data.product if you have either a tiles subscription (soon to be deprecated) or a km² subscription. Pléiades Neo is only accessible through km² subscription.

Here is a snippet of the response showing the price:

{
    "payload": {
        "kind": "order.data.product",
        "products": [
            {
                "productType": "bundle",
                "radiometricProcessing": "REFLECTANCE",
                "imageFormat": "image/jp2",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "d42de348-110b-4ed6-a597-755867b3ee54",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                1.4089965820312502,
                                43.59829500262717
                            ],
                            [
                                1.4089965820312502,
                                43.63408731864001
                            ],
                            [
                                1.5078735351562496,
                                43.63408731864001
                            ],
                            [
                                1.5078735351562496,
                                43.59829500262717
                            ],
                            [
                                1.4089965820312502,
                                43.59829500262717
                            ]
                        ]
                    ]
                }
            }
        ]
    },
    "deliveries": [
        {
            "datas": {
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                1.4089965820312502,
                                43.59829500262717
                            ],
                            [
                                1.5078735351562496,
                                43.59829500262717
                            ],
                            [
                                1.5078735351562496,
                                43.63408731864001
                            ],
                            [
                                1.4089965820312502,
                                43.63408731864001
                            ],
                            [
                                1.4089965820312502,
                                43.59829500262717
                            ]
                        ]
                    ]
                },
                "productType": "bundle",
                "radiometricProcessing": "REFLECTANCE",
                "imageFormat": "image/jp2",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "d42de348-110b-4ed6-a597-755867b3ee54",
                "sourceId": "DS_PHR1A_202201231049180_FR1_PX_E001N43_0615_01724"
            },
            "id": "d42de348-110b-4ed6-a597-755867b3ee54",
            "amount": 222,
            "amountUnit": "kB",
            "isAmountEstimated": "false",
            "areaKm2": 31.73
        }
    ],
    "price": {
        "credits": 222,
        "amount": 222,
        "isAmountEstimated": "false",
        "areaKm2": 31.73,
        "amountUnit": "kB"
    },
    "feasibility": "automatic",
    "orderable": "noAvailableSubscriptionData"
}

The response provides information regarding the number of credits that will be decrease from the customer account when the order will be placed.

Place an Order for an Individual Product

Once you calculated the price of an individual product, you can place the order for true. If you are ready to proceed, then the following endpoint must be used:

API Endpoint/api/v1/orders
REST verbPOST
AuthenticationJWT Token
API ReferenceOrder API

The JSON structure to use is equivalent to the structure used to calculate the price:

{
  "kind": "order.data.product",
  "products": [
    {

            "crsCode": "urn:ogc:def:crs:EPSG::4326",
            "productType": "pansharpened",
            "radiometricProcessing": "DISPLAY",
            "aoi": {
                "type": "Polygon",
                "coordinates": [
        ...
      }
    }
  ]
}

Below is an example of a call:

curl -X POST \
  https://data.api.oneatlas.airbus.com/api/v1/orders \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -d '{
  "kind": "order.data.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "d42de348-110b-4ed6-a597-755867b3ee54",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [1.4089965820312502, 43.59829500262717],
            [1.4089965820312502, 43.63408731864001],
            [1.5078735351562496, 43.63408731864001],
            [1.5078735351562496, 43.59829500262717],
            [1.4089965820312502, 43.59829500262717]
          ]
        ]
      }
    }
  ]
}'
var data = JSON.stringify({
  "kind": "order.data.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "d42de348-110b-4ed6-a597-755867b3ee54",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [1.4089965820312502, 43.59829500262717],
            [1.4089965820312502, 43.63408731864001],
            [1.5078735351562496, 43.63408731864001],
            [1.5078735351562496, 43.59829500262717],
            [1.4089965820312502, 43.59829500262717]
          ]
        ]
      }
    }
  ]
});


var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://data.api.oneatlas.airbus.com/api/v1/orders");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);
import requests

url = "https://data.api.oneatlas.airbus.com/api/v1/orders"

payload = {
  "kind": "order.data.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "d42de348-110b-4ed6-a597-755867b3ee54",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [1.4089965820312502, 43.59829500262717],
            [1.4089965820312502, 43.63408731864001],
            [1.5078735351562496, 43.63408731864001],
            [1.5078735351562496, 43.59829500262717],
            [1.4089965820312502, 43.59829500262717]
          ]
        ]
      }
    }
  ]
}

headers = {
    'Authorization': "Bearer <access_token>",
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Note: Your kind must be order.data.product if you have a GB subscription (soon to be deprecated), or order.data.product if you have either a tiles subscription (soon to be deprecated) or a km² subscription. Pléiades Neo is only accessible through km² subscription.

Here you can see the initial response with status ordered.

{
    "_links": {
        "self": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/fc77c5e2-bcb4-4375-9924-4632e1363930"
        },
        "cancel": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/fc77c5e2-bcb4-4375-9924-4632e1363930/cancel"
        },
        "contract": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/ff731b8d-5637-40aa-89ad-daa736613714"
        },
        "payments": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/fc77c5e2-bcb4-4375-9924-4632e1363930/payments"
        },
        "deliveries": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/fc77c5e2-bcb4-4375-9924-4632e1363930/deliveries"
        },
        "subscription": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/subscriptions/8fe89b39-9745-40b1-9a1f-5ce98aba2b13"
        }
    },
    "id": "fc77c5e2-bcb4-4375-9924-4632e1363930",
    "kind": "order.data.product",
    "service": "data",
    "createdAt": "2022-02-12T10:05:34.548855+00:00",
    "createdBy": "9915b46a-cddd-48e0-49e0-1cc1ddaea356",
    "status": "ordered",
    "contractId": "ff731b8d-5637-40aa-89ad-daa736613714",
    "isAmountEstimated": "true",
    "price": 222,
    "amount": 222,
    "amountUnit": "kB",
    "payload": {
        "kind": "order.product",
        "products": [
            {
            "productType": "bundle",
            "radiometricProcessing": "REFLECTANCE",
            "imageFormat": "image/jp2",
            "crsCode": "urn:ogc:def:crs:EPSG::4326",
            "id": "d42de348-110b-4ed6-a597-755867b3ee54",
            "aoi": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [1.4089965820312502, 43.59829500262717],
                        [1.4089965820312502, 43.63408731864001],
                        [1.5078735351562496, 43.63408731864001],
                        [1.5078735351562496, 43.59829500262717],
                        [1.4089965820312502, 43.59829500262717]
                    ]
                ]
            }
            }
        ]
    },
    "deliveries": [
        {
            "_links": {
                "self": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/deliveries/3d2cefe6-a633-4616-b46d-8ff7e5322dc4"
                },
                "contract": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/ff731b8d-5637-40aa-89ad-daa736613714"
                }
            },
            "id": "3d2cefe6-a633-4616-b46d-8ff7e5322dc4",
            "kind": "delivery.data.product",
            "service": "data",
            "createdAt": "2022-02-12T10:05:34.790364+00:00",
            "status": "processing",
            "isAmountEstimated": "true",
            "price": 222,
            "amount": 222,
            "amountUnit": "kB",
            "area": "31.73",
            "unit": "km2",
            "datas": {
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "productType": "pansharpened",
                "radiometricProcessing": "DISPLAY",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [1.4089965820312502, 43.59829500262717],
                            [1.4089965820312502, 43.63408731864001],
                            [1.5078735351562496, 43.63408731864001],
                            [1.5078735351562496, 43.59829500262717],
                            [1.4089965820312502, 43.59829500262717]
                        ]
                    ]
                },
                "id": "3d2cefe6-a633-4616-b46d-8ff7e5322dc4",
                "imageFormat": "image/jp2",
                "sourceId": "DS_PHR1A_202201231049180_FR1_PX_E001N43_0615_01724",
                "sensor": "PHR",
                "segmentFootprint": {
                    "coordinates": [
                        [
                            [1.4089965820312502, 43.59829500262717],
                            [1.4089965820312502, 43.63408731864001],
                            [1.5078735351562496, 43.63408731864001],
                            [1.5078735351562496, 43.59829500262717],
                            [1.4089965820312502, 43.59829500262717]
                        ]
                    ],
                    "type": "Polygon"
                },
                "processingLevel": "SENSOR",
                "areaKm2": 31.73
            },
            "updatedAt": "2020-02-12T10:05:35.448096+00:00"
        }
    ]
}

Within a few minutes your status will change from ordered to delivered.

Place an order for a product list

API Endpoint/api/v1/orders
REST verbPOST
AuthenticationJWT Token
API ReferenceOrder API

Here is an example of Body request

{ "kind": "order.data.product",
  "products": [
    { 
      "productType": "pansharpened",
      "radiometricProcessing": "DISPLAY",
      "imageFormat": "image/geotiff",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "b6777f1b-5a43-452c-bc1b-42223bac23cb", 
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [-104.775823, 39.790956],
            [-104.776331, 39.790956],
            [-104.776331, 39.791346],
            [-104.775823, 39.791346],
            [-104.775823, 39.790956]
          ]
        ]
      }
    },
    { 
      "productType": "pansharpened",
      "radiometricProcessing": "DISPLAY",
      "imageFormat": "image/geotiff",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "e1ce3f3d-931b-4274-9120-7dd23d0a517d", 
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [-104.775823, 39.790956],
            [-104.776331, 39.790956],
            [-104.776331, 39.791346],
            [-104.775823, 39.791346],
            [-104.775823, 39.790956]
          ]
        ]
      }
    }
  ]
}

Here you can see the initial response with status ordered.

{
    "_links": {
        "self": {
            "href": 
        },
        "cancel": {
            "href": 
        },
        "contract": {
            "href": 
        },
        "payments": {
            "href": 
        },
        "deliveries": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/DELIVERY_ID/deliveries"
        },
        "subscription": {
            "href": 
        },
        "reset": {
            "href": 
        }
    },
    "id": "c77fe842-7a3c-4daf-ab98-ccf8c874765b",
    "kind": "order.data.product",
    "service": "data",
    "createdAt": "2021-01-20T16:59:28.494146+00:00",
    "createdBy": "9998e1d6-849a-4d1c-92fb-59d4881b1bf1",
    "status": "ordered",
    "contractId": "ff731b8d-5637-40aa-89ad-daa736613714",
    "isAmountEstimated": "true",
    "price": 1024,
    "amount": 1024,
    "amountUnit": "kB",
    "payload": {
        "kind": "order.data.product",
        "products": [
            {
                "productType": "pansharpened",
                "radiometricProcessing": "DISPLAY",
                "imageFormat": "image/geotiff",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "b6777f1b-5a43-452c-bc1b-42223bac23cb",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -104.775823,
                                39.790956
                            ],
                            [
                                -104.776331,
                                39.790956
                            ],
                            [
                                -104.776331,
                                39.791346
                            ],
                            [
                                -104.775823,
                                39.791346
                            ],
                            [
                                -104.775823,
                                39.790956
                            ]
                        ]
                    ]
                }
            },
            {
                "productType": "pansharpened",
                "radiometricProcessing": "DISPLAY",
                "imageFormat": "image/geotiff",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "e1ce3f3d-931b-4274-9120-7dd23d0a517d",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -104.775823,
                                39.790956
                            ],
                            [
                                -104.776331,
                                39.790956
                            ],
                            [
                                -104.776331,
                                39.791346
                            ],
                            [
                                -104.775823,
                                39.791346
                            ],
                            [
                                -104.775823,
                                39.790956
                            ]
                        ]
                    ]
                }
            }
        ]
    },
    "deliveries": [
        {
            "_links": {
                "self": {
                    "href": 
                },
                "contract": {
                    "href": 
                }
            },
            "id": "187d72d2-9f52-42ab-8035-2a4321e809f6",
            "kind": "delivery.data.product",
            "service": "data",
            "createdAt": "2021-01-20T16:59:31.612566+00:00",
            "status": "processing",
            "isAmountEstimated": "true",
            "price": 512,
            "amount": 512,
            "amountUnit": "kB",
            "datas": {
                "productType": "pansharpened",
                "radiometricProcessing": "DISPLAY",
                "imageFormat": "image/geotiff",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "e1ce3f3d-931b-4274-9120-7dd23d0a517d",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -104.775823,
                                39.790956
                            ],
                            [
                                -104.775823,
                                39.791346
                            ],
                            [
                                -104.776331,
                                39.791346
                            ],
                            [
                                -104.776331,
                                39.790956
                            ],
                            [
                                -104.775823,
                                39.790956
                            ]
                        ]
                    ]
                },
                "sourceId": "DS_PHR1B_202012051759536_FR1_PX_W105N39_0219_00596",
                "sensor": "PHR",
                "segmentFootprint": {
                    "coordinates": [
                        [
                            [
                                -104.9775688206895,
                                39.80048370323315
                            ],
                            [
                                -104.9774682800691,
                                39.73975995525274
                            ],
                            [
                                -104.736994818145,
                                39.73962758670733
                            ],
                            [
                                -104.7369214405791,
                                39.80035385622021
                            ],
                            [
                                -104.9775688206895,
                                39.80048370323315
                            ]
                        ]
                    ],
                    "type": "Polygon"
                },
                "processingLevel": "SENSOR",
                "areaKm2": 0
            },
            "updatedAt": "2021-01-20T16:59:31.982892+00:00"
        },
        {
            "_links": {
                "self": {
                    "href": 
                },
                "contract": {
                    "href": 
                }
            },
            "id": "08611f3e-c7a5-4c6a-bdba-1534167b96b8",
            "kind": "delivery.data.product",
            "service": "data",
            "createdAt": "2021-01-20T16:59:31.123982+00:00",
            "status": "processing",
            "isAmountEstimated": "true",
            "price": 512,
            "amount": 512,
            "amountUnit": "kB",
            "datas": {
                "productType": "pansharpened",
                "radiometricProcessing": "DISPLAY",
                "imageFormat": "image/geotiff",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "b6777f1b-5a43-452c-bc1b-42223bac23cb",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -104.775823,
                                39.790956
                            ],
                            [
                                -104.775823,
                                39.791346
                            ],
                            [
                                -104.776331,
                                39.791346
                            ],
                            [
                                -104.776331,
                                39.790956
                            ],
                            [
                                -104.775823,
                                39.790956
                            ]
                        ]
                    ]
                },
                "sourceId": "DS_PHR1A_201702201754406_FR1_PX_W105N39_0319_07392",
                "sensor": "PHR",
                "segmentFootprint": {
                    "coordinates": [
                        [
                            [
                                -104.8860614117759,
                                40.16384943953484
                            ],
                            [
                                -104.6503660966169,
                                40.16289246113048
                            ],
                            [
                                -104.6521201437874,
                                39.4181122242012
                            ],
                            [
                                -104.8846661294525,
                                39.41869095699067
                            ],
                            [
                                -104.8860614117759,
                                40.16384943953484
                            ]
                        ]
                    ],
                    "type": "Polygon"
                },
                "processingLevel": "SENSOR",
                "areaKm2": 0
            },
            "updatedAt": "2021-01-20T16:59:31.587653+00:00"
        }
    ]
}

View Order Status

The /orders endpoint can be used to retrieve the status of your orders:

API Endpoint/api/v1/orders
REST verbGET
AuthenticationJWT Token
API ReferenceOrder API

Here below is an example of a call:

curl -X GET "https://data.api.oneatlas.airbus.com/api/v1/orders" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache"
var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = false;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://data.api.oneatlas.airbus.com/api/v1/orders");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Cache-Control", "no-cache");

xhr.send(data);
import requests

url = "https://data.api.oneatlas.airbus.com/api/v1/orders"

headers = {
    'Authorization': "Bearer <access_token>",
    'Content-Type': "application/json",
    'Cache-Control': "no-cache",
    }

response = requests.request("GET", url, headers=headers)

print(response.text)

A filter could be associated to this request to display orders that have a specific status. Available statuses for orders are the following ones:

StatusDescription
errorAn error occurred during the production process.
deliveredThe products have been produced and available in your private workspace.
orderedThe products have just been ordered and will be processed; the production is in progress.
rejectedThe order has been rejected, insufficient balance.

Also, it is possible to filter per product kind, two kinds being available:

KindDescription
order.data.productIndividual image product
order.analytics-toolbox.archiveIndividual Analytics Toolbox product

If there are a lot of results to list, there’s a pagination mechanism to limit the number of results. If you want to activate it, the itemsPerPage parameter can be used.


For example, listing the first order delivered could be requested by using the following:

curl -X GET "https://data.api.oneatlas.airbus.com/api/v1/orders?status=delivered&kind=order.subscription.streaming&page=1&itemsPerPage=1" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache"
var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = false;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://data.api.oneatlas.airbus.com/api/v1/orders??status=delivered&itemsPerPage=1");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Cache-Control", "no-cache");

xhr.send(data);
Not available

And the associated response:

{
    "startIndex": 0,
    "totalResults": 500,
    "countLimitReached": true,
    "itemsPerPage": 1,
    "items": [
        {
            "_links": {
                "self": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/c7d0301b-188b-4476-8ccb-19882bfe0c6a"
                },
                "cancel": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/c7d0301b-188b-4476-8ccb-19882bfe0c6a/cancel"
                },
                "contract": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/ff731b8d-5637-40aa-89ad-daa736613714"
                },
                "payments": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/c7d0301b-188b-4476-8ccb-19882bfe0c6a/payments"
                },
                "deliveries": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/c7d0301b-188b-4476-8ccb-19882bfe0c6a/deliveries"
                },
                "subscription": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/subscriptions/8fe89b39-9745-40b1-9a1f-5ce98aba2b13"
                }
            },
            "id": "c7d0301b-188b-4476-8ccb-19882bfe0c6a",
            "kind": "order.data.product",
            "service": "data",
            "createdAt": "2020-02-18T14:52:23.706942+00:00",
            "createdBy": "3b3af8c8-3fde-4ad5-26fa-a28f6464e067",
            "status": "delivered",
            "contractId": "ff731b8d-5637-40aa-89ad-daa736613714",
            "isAmountEstimated": "false",
            "price": 2049,
            "amount": 2049,
            "amountUnit": "kB",
            "estimatedAmount": 2665,
            "payload": {
                "kind": "order.data.product",
                "products": [
                    {
                        "crsCode": "urn:ogc:def:crs:EPSG::4326",
                        "productType": "pansharpened",
                        "radiometricProcessing": "DISPLAY",
                        "aoi": {
                            "type": "Polygon",
                            "coordinates": [
                                [
                                    [
                                        4.705066680908203,
                                        50.86576445831801
                                    ],
                                    [
                                        4.705066680908203,
                                        50.869271906986995
                                    ],
                                    [
                                        4.714937210083009,
                                        50.869271906986995
                                    ],
                                    [
                                        4.714937210083009,
                                        50.86576445831801
                                    ],
                                    [
                                        4.705066680908203,
                                        50.86576445831801
                                    ]
                                ]
                            ]
                        },
                        "id": "ce6b6688-0400-43cc-99d6-b0e6fe1cdc46",
                        "imageFormat": "image/jp2"
                    }
                ]
            },
            "deliveries": [
                {
                    "_links": {
                        "self": {
                            "href": "https://data.api.oneatlas.airbus.com/api/v1/deliveries/f96b2b86-d0da-4e3f-8dde-31ecfbaa49f6"
                        },
                        "contract": {
                            "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/ff731b8d-5637-40aa-89ad-daa736613714"
                        },
                        "catalogUrl": {
                            "href": "https://search.foundation.api.oneatlas.airbus.com/api/v1/opensearch?id=ba5e3b48-3bc7-4438-8153-552bf6c6c3e2"
                        },
                        "catalogItem": {
                            "href": "https://search.foundation.api.oneatlas.airbus.com/api/v1/opensearch?id=ba5e3b48-3bc7-4438-8153-552bf6c6c3e2"
                        },
                        "download": {
                            "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/ba5e3b48-3bc7-4438-8153-552bf6c6c3e2/download"
                        },
                        "payment": {
                            "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/ff731b8d-5637-40aa-89ad-daa736613714/payments/25fa3352-d739-44c1-85e4-170eba7e8400"
                        }
                    },
                    "id": "f96b2b86-d0da-4e3f-8dde-31ecfbaa49f6",
                    "kind": "delivery.data.product",
                    "service": "data",
                    "createdAt": "2020-02-18T14:52:23.906018+00:00",
                    "status": "delivered",
                    "isAmountEstimated": "false",
                    "price": 2049,
                    "amount": 2049,
                    "estimatedAmount": 2665,
                    "amountUnit": "kB",
                    "area": "0.27",
                    "unit": "km2",
                    "datas": {
                        "crsCode": "urn:ogc:def:crs:EPSG::4326",
                        "productType": "pansharpened",
                        "radiometricProcessing": "DISPLAY",
                        "aoi": {
                            "type": "Polygon",
                            "coordinates": [
                                [
                                    [
                                        4.705066680908203,
                                        50.86576445831801
                                    ],
                                    [
                                        4.705066680908203,
                                        50.869271906986995
                                    ],
                                    [
                                        4.714937210083009,
                                        50.869271906986995
                                    ],
                                    [
                                        4.714937210083009,
                                        50.86576445831801
                                    ],
                                    [
                                        4.705066680908203,
                                        50.86576445831801
                                    ]
                                ]
                            ]
                        },
                        "id": "ce6b6688-0400-43cc-99d6-b0e6fe1cdc46",
                        "imageFormat": "image/jp2",
                        "sourceId": "DS_PHR1A_201705111101521_FR1_PX_E004N50_0923_01783",
                        "sensor": "PHR",
                        "segmentFootprint": {
                            "coordinates": [
                                [
                                    [
                                        4.590889548726914,
                                        51.01415297509098
                                    ],
                                    [
                                        4.905543929335252,
                                        51.0226354352714
                                    ],
                                    [
                                        4.905286153735808,
                                        50.833949505459
                                    ],
                                    [
                                        4.590360936603221,
                                        50.82714044986403
                                    ],
                                    [
                                        4.590889548726914,
                                        51.01415297509098
                                    ]
                                ]
                            ],
                            "type": "Polygon"
                        },
                        "processingLevel": "SENSOR",
                        "areaKm2": 0.27
                    },
                    "updatedAt": "2020-02-18T14:54:40.909548+00:00",
                    "deliveredAt": "2020-02-18T14:54:40.909548+00:00"
                }
            ]
        }
    ]
}
Contact Us