Overlap Object

Overlap details are only provided if searching by a bounding box (or polygon in the future), it will be absent if searching by a point. The Overlap object has the following structure:

{
  "area": 0,
  "percent": 0,
  "polygon": []
}

field	data type	purpose
area	number	area in sq km of the overlap between search and result
percent	number	percent of the original search area this scene overlaps
polygon	[][]number	polygon of overlap area

Pricing Object

Many suppliers require different licencing or pricing to licence additional seats to the imagery, as well as allowing purchase of whole scenes, or just the Area Of Interest (AOI), this object provides details for the different pricing options.
All pricing is provided in US cents.
Depending on your search criteria, two different prices may be available for your imagery.
The price object provides these details, as well as which options are available.
The price object has two fields:
- scene: which provides pricing for purchasing a whole image capture (what you see in the thumbnail image), or
- aoi: which is only available if searching by an area (much like the overlap object above), and provides pricing for only purchasing the imagery in your search area. This field may also be absent, indicating an inability to purchase only the AOI portion of this scene, for any of the following reasons:
 - the supplier does not support AOI ordering (such as landsat)
 - the portion of your AOI within this scene is less than the suppliers minimum order
 - the portion of your AOI within this scene fails supplier swath width requirements
The contents of the scene and aoi fields is a pricing object, which has the following structure:

{
  "base": 0,
  "seats": [
      {
          "min": 0,
          "max": 0,
          "additional": 0
      }
  ]
}

field	data type	purpose
base	number	the base static price for the imagery, this is the portion the image will always cost
seats	array	each organisation that uses the image constitutes a seat. If you are distributing this image to other organisations, this will apply. Please consult the EULA for more information.
min	number	minimum number of seats to which this price range applies
max	number	maximum number of seats to which this price range applies (0 represents no maximum)
additional	number	the additional price to be paid in this range

All imagery will cost its base price, and purchases with additional seats may attract additional charges, described by this structure.
If the seats array is empty, no additional charge is applicable for any seat number.
If the seats array is populated, each object represents pricing for a range of seats and the additional amount to be added to base for purchasing this imagery.
The applicable entry is one where the required number of seats is:
- greater than or equal to that entry's min value
- less than or equal to that entry's max value, or that entry's max value is 0 (representing no upper bounds)
When purchasing the imagery, the amount charges to the requesting users account will be base + additional for the appropriate seats entry.

Ordering Scenes or Areas of Interest

The `trim` parameter is a powerful and important part of the order endpoint, and it controls both the balance changed to your account, and the imagery provided.
When `trim` is not present, or is false, the whole scene's imagery will be ordered and the price stipulated in the `price.scene` field of the search result will be charged.
When `trim` is true. Your account will be charged the amount stipulated in `price.aoi`; and the imagery ordered will be the intersection of the scene and your search area (defined in the `overlap` field of the search result).
Trim may only be true if the search result included a `price.aoi` value. If it does not, review the `annotations` field for the reason AOI ordering is not available for this result.

{
  "id": "",
  "createdAt": "",
  "updatedAt": "",
  "supplier": "",
  "imageryID": "",
  "status": "",
  "total": 0,
  "resources": [
    { Resource },
    { Resource },
    ...
  ]
}

{
  "id": "",
  "createdAt": "",
  "updatedAt": "",
  "order": "",
  "name": "",
  "type": ""
}