API errors
Specific error codes along with their status codes and meaning are described in this part of the documentation. See also OpenAPI docs.
General API Error Codes
400
EXTENT-TOO-SMALL– Scene GSD is too coarse for the requested algorithm.EXTENT-HAS-NO-INTERSECTION– Requested extent has no intersection with involved scenes.BAD-PROTOCOL– Only https protocol is supported.INVALID_PIPELINE_RESULT– Pipeline result does not match this endpoint.BAD-REQUEST– Request cannot be fulfilled.BAD-CONTENT-TYPE– Passed content type is not allowed for this endpoint.
401 (see also authorization and permissions.)
NOT-AUTHORIZED– User is not authorized to access this resource.INVALID-AUTHORIZATION-HEADER– Request authorization header is malformed or missing.
402
CREDITS-ERROR– Requested scene or tile is not allocated.
403
USER-AUTHORIZATION-NOT-PERMITTED– User authorization is not permitted for this endpoint.AUTHORIZATION-WITHOUT-CONTEXT-NOT-PERMITTED– API key authorization requires user ID and accounting for this endpoint.API-KEY-AUTHORIZATION-NOT-PERMITTED– API key authorization is not permitted for this endpoint.
404
NON-EXISTENT-ENDPOINT– Requested endpoint does not exist.NO-VALID-BINDING– User is not bound to any credit group.
405
METHOD-NOT-ALLOWED– Used HTTP method is not allowed for this endpoint.
413
PAYLOAD-TOO-LARGE– Request body payload is too large.
422
VALIDATION-ERROR– Request body (or query) did not pass validation.
424
PROCESSING-ERROR– Something went wrong in pipeline processing.
500
ERROR– Unexpected error occurred, please try again later.
Tasking API Error Codes
404
NON-EXISTENT-PIPELINE– Requested pipeline does not exist.
Ragnar API Error Codes
400
UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.INVALID-GEOMETRY-GEOFENCE– Requested geometry is outside of the allowed geometry due to Geo-Fencing.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.
404
NON-EXISTENT-PIPELINE– Requested pipeline does not exist.NO-THUMBNAIL-AVAILABLE– Requested thumbnail is not available.NON-EXISTING-SCENE– Requested scene does not exist.
Kraken API Error Codes
400
UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.INVALID-GEOMETRY-GEOFENCE– Requested geometry is outside of the allowed geometry due to Geo-Fencing.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.NON-EXISTENT-GEOMETRY– Geometry does not exist.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.INVALID-MAP-ID– Encoded map ID is invalid.
401 (see also authorization and permissions.)
NOT-PERMITTED-COORDINATES– Requested coordinates are not permitted for given map ID.ACCESS-DENIED– You do not have permissions to access other users’ resources.
404
NON-EXISTENT-PIPELINE– Requested pipeline does not exist.TILE-DOES-NOT-EXIST– Requested kraken grid tile does not exist.UNSUPPORTED-FILE-NAME– Requested kraken grid file is not supported for this map type.NO-THUMBNAIL-AVAILABLE– Requested thumbnail is not available.NON-EXISTING-SCENE– Requested scene does not exist.
Geojsondb API Error Codes
400
UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.INVALID-GEOMETRY-GEOFENCE– Requested geometry is outside of the allowed geometry due to Geo-Fencing.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.NON-EXISTENT-GEOMETRY– Geometry does not exist.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.INVALID-MAP-ID– Encoded map ID is invalid.
401 (see also authorization and permissions.)
NOT-PERMITTED-COORDINATES– Requested coordinates are not permitted for given map ID.ACCESS-DENIED– You do not have permissions to access other users’ resources.
404
NON-EXISTENT-PIPELINE– Requested pipeline does not exist.TILE-DOES-NOT-EXIST– Requested kraken grid tile does not exist.UNSUPPORTED-FILE-NAME– Requested kraken grid file is not supported for this map type.NO-THUMBNAIL-AVAILABLE– Requested thumbnail is not available.NON-EXISTING-SCENE– Requested scene does not exist.
User API Error Codes
400
TOO-BIG-TILE-AREA– Requested area is too big for one analysis.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.INVALID-GEOMETRY-GEOFENCE– Requested geometry is outside of the allowed geometry due to Geo-Fencing.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.USER-BLOCKED– User is blocked and unavailable for the requested operation.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.INVALID-MAP-ID– Encoded map ID is invalid.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.NON-EXISTENT-GEOMETRY– Geometry does not exist.
401 (see also authorization and permissions.)
ACCESS-DENIED– You do not have permissions to access other users’ resources.NOT-PERMITTED-COORDINATES– Requested coordinates are not permitted for given map ID.
404
TILE-DOES-NOT-EXIST– Requested kraken grid tile does not exist.NON-EXISTENT-USER– Requested user does not exist.UNSUPPORTED-FILE-NAME– Requested kraken grid file is not supported for this map type.NON-EXISTING-SCENE– Requested scene does not exist.NON-EXISTENT-PIPELINE– Requested pipeline does not exist.NO-THUMBNAIL-AVAILABLE– Requested thumbnail is not available.
409
CONFLICT– Can’t modify this resource because of a conflict in data.
429
TOO-MANY-REQUESTS– Too many requests, please try again later.
Credits API Error Codes
400
TOO-BIG-TILE-AREA– Requested area is too big for one analysis.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.INVALID-GEOMETRY-GEOFENCE– Requested geometry is outside of the allowed geometry due to Geo-Fencing.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.NOT-UNIQUE-TRANSACTION– Transaction is not unique.USER-BLOCKED– User is blocked and unavailable for the requested operation.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.INVALID-MAP-ID– Encoded map ID is invalid.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.NON-EXISTENT-GEOMETRY– Geometry does not exist.
401 (see also authorization and permissions.)
ACCESS-DENIED– You do not have permissions to access other users’ resources.EXPIRED-LICENSE– Group license is expired.NOT-PERMITTED-COORDINATES– Requested coordinates are not permitted for given map ID.NOT-ENOUGH-CREDITS– User group does not have enough credits for requested action.
404
TILE-DOES-NOT-EXIST– Requested kraken grid tile does not exist.NON-EXISTENT-USER– Requested user does not exist.NON-EXISTENT-COST-TIER– Requested cost tier does not exist.UNSUPPORTED-FILE-NAME– Requested kraken grid file is not supported for this map type.NON-EXISTING-SCENE– Requested scene does not exist.NON-EXISTENT-PIPELINE– Requested pipeline does not exist.NO-THUMBNAIL-AVAILABLE– Requested thumbnail is not available.
409
CONFLICT– Can’t modify this resource because of a conflict in data.
424
EXTENT-TOO-LARGE– Image pixel area is larger than maximum allowed area.
429
TOO-MANY-REQUESTS– Too many requests, please try again later.
Datacube API Error Codes
400
TOO-BIG-TILE-AREA– Requested area is too big for one analysis.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.INVALID-GEOMETRY-GEOFENCE– Requested geometry is outside of the allowed geometry due to Geo-Fencing.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.NOT-UNIQUE-TRANSACTION– Transaction is not unique.USER-BLOCKED– User is blocked and unavailable for the requested operation.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.INVALID-MAP-ID– Encoded map ID is invalid.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.NON-EXISTENT-GEOMETRY– Geometry does not exist.
401 (see also authorization and permissions.)
ACCESS-DENIED– You do not have permissions to access other users’ resources.NO-MATCHING-PACKAGE– You are not allowed to use requested resource.EXPIRED-LICENSE– Group license is expired.NOT-PERMITTED-COORDINATES– Requested coordinates are not permitted for given map ID.NOT-ENOUGH-CREDITS– User group does not have enough credits for requested action.
404
TILE-DOES-NOT-EXIST– Requested kraken grid tile does not exist.NON-EXISTENT-USER– Requested user does not exist.NON-EXISTENT-COST-TIER– Requested cost tier does not exist.UNSUPPORTED-FILE-NAME– Requested kraken grid file is not supported for this map type.PRODUCT-HAS-NO-DATA– No data found for requested product.NON-EXISTING-SCENE– Requested scene does not exist.NON-EXISTENT-PRODUCT– Requested product does not exist.NON-EXISTENT-PIPELINE– Requested pipeline does not exist.NO-THUMBNAIL-AVAILABLE– Requested thumbnail is not available.
409
CONFLICT– Can’t modify this resource because of a conflict in data.
424
EXTENT-TOO-LARGE– Image pixel area is larger than maximum allowed area.UNSUPPORTED-POSTPROCESS– Used datacube postprocess is not supported.
429
TOO-MANY-REQUESTS– Too many requests, please try again later.