Bring Your Own COG / Batch

About BYOC / Batch Data

Bring Your Own COG (BYOC) and Batch data is data ingested by Sentinel Hub users using BYOC API and Batch API, respectively.

Accessing data

Data is accessed using Sentinel Hub APIs, just like any other data you are used to. In all cases collection id is needed, which can be obtained from your dashboard. You also need to access data from the correct endpoint.

Endpoint Locations

BYOC endpoints

ServiceNotes data in AWS buckets in EU-Central-1 region data in AWS buckets in US-West-2 region data in CREODIAS buckets data in CODE-DE buckets

For the list of endpoints where batch collections are available, see here.

Data type identifier

Use byoc-<collectionId> for BYOC, and batch-<collectionId> for Batch as the value of the parameter in your API requests. For example, set it to byoc-017aa0ae-33a6-45d3-8548-0f7d1041b40c for BYOC collection with id 017aa0ae-33a6-45d3-8548-0f7d1041b40c.

Request resolution limit

For the limit, we take five times the median resolution of the lowest resolution overview of all tiles in the collection. If this resolution is higher than 500 meters per pixel, the limit is set at 500 meters per pixel. This is to allow for more zoomed out viewing. Note, only overviews which are at least 256 pixels in either width or height are used for this computation. Adding or removing tiles from a collection will recompute its limit.

You can see the computed resolution limit for a collection in the collection details in your dashboard. Alternatively, in the response if querying a collection using the BYOC API.

Filtering Options

This chapter will explain the object.


Sets the order of overlapping tiles from which the output result is mosaicked. The tiling is defined by the user when ingesting the data in the collection.

mostRecentThe pixel will be selected from the tile, which the most recent sensing time.In case there are more tiles available with the same sensing time, the one, which was created later will be used.
leastRecentSimilar to mostRecent but in reverse order.

Processing Options

This chapter will explain the object of the process API.

upsamplingDefines the interpolation used for processing when the pixel resolution is greater than the source resolution (e.g. 5m/px with a 10m/px source)NEAREST - nearest neighbour interpolation
BILINEAR - bilinear interpolation
BICUBIC - bicubic interpolation
downsamplingAs above except when the resolution is lower.NEAREST - nearest neighbour interpolation
BILINEAR - bilinear interpolation
BICUBIC - bicubic interpolation

Available Bands and Data

Since collections contains your data this means that the available bands are the ones you have prepared. The band names to use in you evalscript are also listed in each collection in your dashboard.

dataMask is also available. In BYOC, dataMask value equals 1 only when a pixel is contained within cover geometry of a BYOC tile and when a pixel has data at the same time. All other instances (e.g. a pixel with data outside tile's cover geometry or a pixel with no-data within tile's cover geometry) will result in dataMask 0. Note also that for floating point rasters, NaN is always treated as no data. See here for more information.


The only units available are digital numbers (DN) so any unit conversions, if necessary, are the responsibility of your evalscript.


To access your data via OGC you need to create a layer in the Configuration utility in either an existing or new configuration. When adding a layer you should set Source to Bring Your Own COG and Collection id to the id of your collection. You should also enter a custom script in Data processing field. This should return the appropriate values based on bands that are defined in the collection.

Once this is done the layer can be used via OGC API in the usual way.

For example:<MyInstanceID>?REQUEST=GetMap&BBOX=15959450,8695500,16059450,8795500&CRS=EPSG:3857&WIDTH=500&HEIGHT=500&LAYERS=<MyLayerName>


To query your tiles using WFS you need to set the WFS feature type (TYPENAMES parameter) to byoc-<MyCollectionID> for BYOC, and batch-<MyCollectionID> for Batch, e.g. byoc-a550f5e9-84d0-441a-8338-bbb04d42a72e.

Here is an example of a WFS GetFeature request:<MyInstanceID>?SERVICE=wfs&REQUEST=GetFeature&BBOX=-90,180,90,-180&SRSNAME=EPSG:4326&OUTPUTFORMAT=application/json&TYPENAMES=byoc-<MyCollectionID>

Catalog API Capabilities

To access Landsat BYOC or Batch product metadata you need to send search request to our Catalog API. The requested metadata will be returned as JSON formatted response to your request.

Endpoint Locations

ServiceNotes<collection id>BYOC and Batch<collection id>BYOC only<collection id>BYOC only<collection id>BYOC only

Collection identifier: <collection id>

Distinct extension

  • date