This changelog lists all of the user-facing changes to the ICEYE API since its initial release in May 2024.
Company API: New imagingModeCapabilities field in contract responses provides per-imaging-mode product type details.
Tasking API: The additionalProductTypes parameter in POST /tasking/v1/tasks is now deprecated and no longer supported. Requests using this parameter will receive a 400 Bad Request error.
Catalog API: Fixed sort order behavior in GET /catalog/v1/items and POST /catalog/v1/search endpoints to correctly maintain the order specified via sortby parameter.
Tasking API: Enhanced additionalProductTypes parameter in createTask to allow requesting SICD or SIDD individually or together when defined as SLA products in contract.
Company API: Improved error handling to return HTTP 400 for invalid pagination limits.
Tasking API: Improved error handling to return HTTP 400 for invalid pagination limits and HTTP 404 for missing task products.
Catalog API: Improved error handling to return HTTP 400 for invalid pagination limits.
Tasking API: Added support for tasking Spot Fine 1-look images via SPOTLIGHT_FINE_1L imaging mode in createTask operation.
Tasking API: Added support for tasking Dwell Precise images via SPOTLIGHT_EXTENDED_DWELL_PRECISE imaging mode in createTask operation.
Tasking API: Improved getTask and listTasks responses to omit eula field when tasks don't have a EULA specified.
Tasking API: Updated createTask to automatically set default incidenceAngle range to the recommended Performant Incidence Range for the specified imaging mode.
Tasking API: getTaskProduct endpoint now filters to show only suitable-for-delivery products.
Catalog API: listPurchaseProducts endpoint now filters to show only suitable-for-delivery products.
Company API: Fixed spec to correctly show imagingModes.allowed as array instead of nested array.
Catalog API: Fixed metadata query property from start_datetime to start_time in POST /catalog/v1/search to align with STAC specification.
Catalog API: Added new POST /catalog/v1/search endpoint with STAC API Query Extension support and removed incomplete query parameter from listCatalogItems.
Tasking API: Fully implemented getTaskScene operation.
Catalog API: Added optional reference parameter to purchaseCatalogItems for tracking purchased items, now included in getPurchasedItem and listPurchasedItems responses.
Company API: Contract endpoints now include EULA settings.
Catalog API: getPurchaseItem fixed to return HTTP 404 for missing purchases.
Tasking API: getTaskScene noted as fully supported.
Tasking API: Dwell imaging mode now automatically requests CSI and VID as standard products.
Catalog API: listCatalogItems simplified to return each image once instead of per product type.
Company API: Fixed listContracts error responses to return correct HTTP statuses.
Catalog API: Corrected OpenAPI spec bug in purchaseCatalogItems replacing purchaseIds with itemIds.
Tasking API: createTask now defaults exclusivity from contract's ImagesPrivateByDefault setting. All endpoints: Enabled problem details format via application/problem+json Accept header.
Catalog API: Fixed validation bug in listCatalogItems operation affecting the bbox query parameter.
Tasking API: Added eula parameter support, and task responses now include deliveryLocations.
Company API: Added eula parameter support.
All endpoints: Enhanced request validation framework to enforce API specification conformance.
Tasking API: Refactored delivery location specification in createTask to use deliveryLocations array, and removed QUICKLOOK from additional product types.
Company API: Removed id field from delivery locations.
Tasking API: Delivery location IDs now formatted as UUID5 strings, fixed createTask error code for invalid pricing constraints, and added QUICKLOOK to additional product types list.
Tasking API: Improved getPrice error handling to return appropriate errors for expired/invalid contracts and contracts without pricing plans.
Tasking API: Enhanced createTask validation to return ERR_OUT_OF_BOUND_CONTRACT error when contract is expired, not yet valid, or will expire during acquisition window.
Tasking API: Added createdAfter and createdBefore parameters to GET /tasking/v1/tasks for date-time filtering, and fixed createTask priority display bug.