Skip to main content

​
Overview

This endpoint allows user to get status of download request made of assets in an AOI. A successful request returns a list of download id and signed url to download the assets. Authentication via API key is mandatory, and errors like 404 or 500 return standard error messages with relevant codes and details.

  • Method: GET
  • URL: /v0/aois/{aoi_id}/downloads/{download_id}
  • Operation: Get status of download request of assets in an AOI
  • Authentication Required: Yes

​
Authorization

You need the api key which you can get from the API tab in Workspace Settings. The api key is required in almost all the commands

Authorization: <YOUR_API_KEY>

​
Path Parameters

The aoi_id and download_id identifies the exact AOI whose download request status is to be returned.

FieldTypeRequiredDescription
aoi_idstringYesUnique identifier of the AOI
download_idstringYesUnique identifier of the requested download

​
Response

​
Successful Response – 200 OK

A 200 OK response from the Get status of a download request endpoint indicates that the request was successful. It returns a download id, signed url and status.Refer to the table below for the detailed breakdown of each field in the API response:AOI Object Fields
FieldTypeDescription
download_idstringUnique identifier for the Download request.
signed_urlstringURL to download the requested asset
statusstringCurrent status of the download request (e.g., "success").
Below is the complete JSON request for listing assets for an AOI using the List Assets for an AOI endpoint. Customize the values as needed for your search criteria:
200
{
  "download_id": "<string>",
  "signed_url": "https://storage.account/download",
  "status": "SUCCESS"
}
  • If you recieve a Not Found error (404) or the Internal Server Error (500), you will get the following response:
404 500
{
  "error": {
    "code": "<string>",
    "details": "<any>",
    "message": "<string>"
  }
}

​
How to use endpoint

  1. Construct your Request:
    Add your API key to the Authorization header and add the path parameter.
  2. Send the Request:
    Include the json body with correct path parameter and send the request to: https://api.pixxel.space/v0/aois/{aoi_id}/downloads/{download_id}.
  3. Examine the Response:
    A successful response (200 OK) returns a status which describess the downlaod status. In case of failure (404, 500), structured error messages with code, message, and details will be returned.