Skip to main content
GET
/
v0
/
aoi
/
{aoi_id}
Get AOI
curl --request GET \
  --url https://api.pixxel.space/v0/aoi/{aoi_id} \
  --header 'Authorization: <api-key>'
{
  "aoi_id": "e9767554-550e-4464-a677-b8cf096073ab",
  "name": "AOI-Bangalore",
  "description": "This AOI contains images related to Bangalore",
  "satellite_id": "ce5dcc14-8291-4b0c-a278-8c05ec426d22",
  "project_id": "ce5dcc14-8291-4b0c-a278-8c05ec426d18",
  "images": {},
  "eo_bands": [
    "B01",
    "B02",
    "B03"
  ],
  "geometry": {
    "coordinates": [
      [
        [
          123
        ]
      ]
    ],
    "type": "<string>"
  },
  "progress": 100,
  "status": "success",
  "is_favourite": false,
  "created_at": "2022-11-14 12:55:49.125928+00:00",
  "updated_at": "2022-11-14 12:55:49.125928+00:00",
  "user_id": "user-123456",
  "area_in_sq_m": 123456.78,
  "centroid": [
    77.55,
    12.95
  ]
}
📚 View developer guide to learn more

Authorizations

​
Authorization
string
header
required

Path Parameters

​
aoi_id
string
required

AOI ID

Response

OK

​
aoi_id
string

ID of the AOI

Example:

"e9767554-550e-4464-a677-b8cf096073ab"

​
name
string

AOI name

Example:

"AOI-Bangalore"

​
description
string

AOI description

Example:

"This AOI contains images related to Bangalore"

​
satellite_id
string

Satellite ID

Example:

"ce5dcc14-8291-4b0c-a278-8c05ec426d22"

​
project_id
string

Project ID this AOI belongs to

Example:

"ce5dcc14-8291-4b0c-a278-8c05ec426d18"

​
images
object

Images associated with the AOI

​
eo_bands
string[]

EO bands

Example:
["B01", "B02", "B03"]
​
geometry
object

Geometry of the AOI

​
progress
integer

Progress of the AOI from 0 to 100 in percentage

Example:

100

​
status
enum<string>

Status of the AOI

Available options:
success,
started,
running,
failed,
updating,
partial_success
Example:

"success"

​
is_favourite
boolean

Whether the AOI is marked as favourite

Example:

false

​
created_at
string

AOI creation datetime

Example:

"2022-11-14 12:55:49.125928+00:00"

​
updated_at
string

AOI update datetime

Example:

"2022-11-14 12:55:49.125928+00:00"

​
user_id
string

User ID who created the AOI

Example:

"user-123456"

​
area_in_sq_m
number

Area in square meters

Example:

123456.78

​
centroid
number[]

Centroid coordinates

Example:
[77.55, 12.95]