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
BAD-REQUEST– Request cannot be fulfilled.BAD-CONTENT-TYPE– Passed content type is not allowed for this endpoint.BAD-PROTOCOL– Only https protocol is supported.EXTENT-HAS-NO-INTERSECTION– Requested extent has no intersection with involved scenes.EXTENT-TOO-SMALL– Scene GSD is too coarse for the requested algorithm.
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
AUTHORIZATION-WITHOUT-CONTEXT-NOT-PERMITTED– API key authorization requires user ID and accounting for this endpoint.USER-AUTHORIZATION-NOT-PERMITTED– User authorization is not permitted for this endpoint.API-KEY-AUTHORIZATION-NOT-PERMITTED– API key authorization is not permitted for this endpoint.
404
NO-VALID-BINDING– User is not bound to any credit group.NON-EXISTENT-ENDPOINT– Requested endpoint does not exist.
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
DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.
404
NON-EXISTENT-PIPELINE– Requested pipeline does not exist.NON-EXISTING-SCENE– Requested scene does not exist.
Kraken API Error Codes
400
NON-EXISTENT-GEOMETRY– Geometry does not exist.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.INVALID-MAP-ID– Encoded map ID is invalid.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.
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
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.NON-EXISTING-SCENE– Requested scene does not exist.
424
PERCENTILE-STRETCH-UNAVAILABLE– Percentile stretch visualization is unavailable for this scene.
Geojsondb API Error Codes
400
NON-EXISTENT-GEOMETRY– Geometry does not exist.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.INVALID-MAP-ID– Encoded map ID is invalid.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.
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
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.NON-EXISTING-SCENE– Requested scene does not exist.
424
PERCENTILE-STRETCH-UNAVAILABLE– Percentile stretch visualization is unavailable for this scene.
User API Error Codes
400
NON-EXISTENT-GEOMETRY– Geometry does not exist.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.INVALID-MAP-ID– Encoded map ID is invalid.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.
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
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.NON-EXISTENT-USER– Requested user does not exist.NON-EXISTING-SCENE– Requested scene does not exist.
409
CONFLICT– Can’t modify this resource because of a conflict in data.
424
PERCENTILE-STRETCH-UNAVAILABLE– Percentile stretch visualization is unavailable for this scene.
429
TOO-MANY-REQUESTS– Too many requests, please try again later.
Credits API Error Codes
400
INVALID-MAP-ID– Encoded map ID is invalid.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.NON-EXISTENT-GEOMETRY– Geometry does not exist.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.
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.NOT-ENOUGH-CREDITS– User group does not have enough credits for requested action.EXPIRED-LICENSE– Group license is expired.
404
NON-EXISTENT-COST-TIER– Requested cost tier does not exist.NON-EXISTING-SCENE– Requested scene does not exist.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.NON-EXISTENT-USER– Requested user does not exist.
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.PERCENTILE-STRETCH-UNAVAILABLE– Percentile stretch visualization is unavailable for this scene.
429
TOO-MANY-REQUESTS– Too many requests, please try again later.
Datacube API Error Codes
400
INVALID-MAP-ID– Encoded map ID is invalid.TOO-BIG-TILE-AREA– Requested area is too big for one analysis.GSD-TOO-COARSE– Scene GSD is too coarse for the requested algorithm.DATASET-NOT-SUPPORTED-FOR-SEARCH– Dataset is deprecated and does not support searching for imagery.UNSUPPORTED-IMAGERY– Operation is not supported on requested imagery.NON-EXISTENT-GEOMETRY– Geometry does not exist.INVALID-GEOJSON– GeoJSON is outside Web Mercator latitude bounds.INVALID-QUERY-PARAMETER– Kraken tile grid query parameter is invalid.
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.NO-MATCHING-PACKAGE– You are not allowed to use requested resource.NOT-ENOUGH-CREDITS– User group does not have enough credits for requested action.EXPIRED-LICENSE– Group license is expired.
404
PRODUCT-HAS-NO-DATA– No data found for requested product.NON-EXISTENT-COST-TIER– Requested cost tier does not exist.NON-EXISTING-SCENE– Requested scene does not exist.NON-EXISTENT-PRODUCT– Requested product does not exist.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.NON-EXISTENT-USER– Requested user does not exist.
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.PERCENTILE-STRETCH-UNAVAILABLE– Percentile stretch visualization is unavailable for this scene.UNSUPPORTED-POSTPROCESS– Used datacube postprocess is not supported.
429
TOO-MANY-REQUESTS– Too many requests, please try again later.