Albedo provides API endpoints that allow a user to check in on the status of their orders, with the following operations:

Search for orders using a filter
Retrieve a specific order
Retrieve an order's timeline

Searching for Orders

All: To list all of the user's orders, the user can Search for Tasking Orders without any filtering parameters
Filters: Search based on a min/max acquisition date range, an order status, or both.

Tasking Order Status

The status field indicates in which stage of the order lifecycle the order resides. The timeline field includes an array of events that record the history of the order's status (calculation_type=ACTUAL), and predictions for when the next stages will occure (calculation_type=ESTIMATE). The diagram below depicts the various order statuses and the conditions that trigger transitions between them:

NOT_FEASIBLE: The order submitted is immediately infeasible. The user should try to submit a new order with either a new AOI, time frame, or other less-constrained parameters
SUBMITTED: The order has been accepted by Albedo because we believe there is a reasonable chance we can successfully collect the order
SCHEDULED: The order has been put on the schedule for imminent collection. This status returns both the time the order was scheduled internally and the approximate collection time
COLLECTING: Commands have been uplinked to the satellite to take imagery for the order
COLLECTED: The imagery for the order has been successfully processed, downlinked, and covers the order's AOI
FULFILLED: The imagery for the order has been made available for the customer to access

Get a Specific Tasking Order

When a user successfully submits a tasking order, the return response contains an order id

{
  "id": 1234, <----- THIS
  "status": "SUBMITTED"
  "aoi": {
    "wkt": ....

This order ID can be used to retrieve details about the associated order, which will contain the following information (seen also in the example response below)

id: Order ID

aoi: Area of Interest

status: Current order status (for more info, see Tasking Order Status below)

next_event: A quick reference to the next expected order status transition

timeline: A history of the order's status changes, and estimated future status changes

tasking_spec: The constraints to apply when tasking the satellite

product_urls: List of associated catalog urls for the products created from the order's imagery

{
    "id": "640",
    "status": "COLLECTING",
    "aoi": {
      "geojson": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -82.09149048704708,
              33.53717960485386
            ],
            [
              -81.87725708860958,
              33.53717960485386
            ],
            [
              -81.87725708860958,
              33.35613179503792
            ],
            [
              -82.09149048704708,
              33.35613179503792
            ],
            [
              -82.09149048704708,
              33.53717960485386
            ]
          ]
        ]
      }
    },
    "timeline": [
      {
        "time": "2022-12-22T19:57:29.588",
        "calculation_type": "ACTUAL",
        "status": "SUBMITTED"
      },
      {
        "time": "2022-12-22T20:57:29.620",
        "status": "SCHEDULED",
        "calculation_type": "ACTUAL",
        "image_events": [
          {
            "image_id": 242515,
            "status": "SCHEDULED",
            "time": "2022-12-22T20:57:29.620"
          }
        ]
      },
      {
        "time": "2022-12-22T21:00:43.974",
        "status": "COLLECTING",
        "calculation_type": "ACTUAL",
        "image_events": [
          {
            "image_id": 242515,
            "status": "UPLINKED",
            "time": "2022-12-22T21:00:43.974"
          },
          {
            "image_id": 242515,
            "status": "IMAGING",
            "time": "2022-12-22T21:22:52.141"
          },
          {
            "image_id": 242515,
            "status": "DOWNLINKED",
            "time": "2022-12-22T21:44:13.312"
          },
          {
            "image_id": 242515,
            "status": "PROCESSING",
            "time": "2022-12-22T21:45:02.211"
          },
          {
            "image_id": 242515,
            "status": "PROCESSED",
            "time": "2022-12-22T21:52:33.121"
          }
        ]
      },
      {
        "time": "2022-12-22T22:36:05.247",
        "status": "FULFILLED",
        "calculation_type": "ESTIMATE"
      }
    ],
    "tasking_spec": {
      "min_acquisition_date_time": "2022-12-22T00:00:00.000+00:00",
      "max_acquisition_date_time": "2022-12-26T00:00:00.000+00:00"
    },
    "product_urls": [
      "https://rest-api.albedodev.com/catalog/242515"
    ]
  }