RISC API

RISC API Latest Release Version 0.2

Submit S2DR3 processing jobs, check job state, and locate generated outputs with the RISC API.

Release label: 20250917.

The RISC API lets you submit asynchronous S2DR3 processing jobs. A job submission returns metadata immediately. The generated products appear in the corresponding storage location after processing.

Submit a Job

Endpoint:

https://s2dr3-job-20250428-862134799361.europe-west1.run.app/{USER_ID}

Method:

POST

Example payload:

{
  "date": "2023-05-01",
  "aoi": "19.93 49.28 20.00 49.35"
}

Request Parameters

Parameter	Required	Description
`date`	Yes	Exact Sentinel-2 scene date. The request fails if the scene does not exist.
`aoi`	Yes	Bounding box for the area of interest in `minx miny maxx maxy` order. The source states the AOI should not exceed 150 km2 / a 12x12 km bounding box.

Example Response

The API returns job metadata, not the processed data itself.

{
  "ISO": "UA",
  "MGRS": "35UQR",
  "PID": "T35UQR-20230810-u8600146",
  "aoi_overlap": "1.0",
  "bbox": "30.85 50.39 30.88 50.42",
  "date": "20230810",
  "job_id": "e26bb408-d330-11ef",
  "save_path_MS": "gs://sentinel-s2dr3/UA/T35UQR/T35UQR-u8600146/S2L2Ax10_T35UQR-u8600146-20230810_MS.tif",
  "save_path_TCI": "gs://sentinel-s2dr3/UA/T35UQR/T35UQR-u8600146/S2L2Ax10_T35UQR-u8600146-20230810_TCI.tif"
}

Important response fields:

Field	Description
`job_id`	Identifier used to check processing state.
`save_path_MS`	Storage path for the super-resolved multispectral dataset.
`save_path_TCI`	Storage path for the super-resolved true-color dataset.

Check Job State

Endpoint pattern:

https://s2dr3-job-20250428-862134799361.europe-west1.run.app/{USER_ID}/{job_id}

Method:

GET

Example response:

{
  "PID": "T35UQR-u8600146-20230810",
  "State": "completed",
  "jobID": "e26bb408-d330-11ef"
}

One Colab example shows a lowercase state field in the returned JSON. Treat field casing as an implementation detail until the public API response schema is confirmed.

Download Outputs

Some examples return gs:// paths. In a Colab workflow, convert a Google Cloud Storage path to an HTTPS URL before downloading:

save_url_MS = save_path_MS.replace("gs://", "https://storage.googleapis.com/")

The uploaded examples also include direct downloads from storage.googleapis.com and from an S3 host for generated output products. Confirm the supported download route for your account before automating downloads.

Tile Server URLs

The source includes tile-server patterns for TCI, NDVI, and IRP COG outputs. Use the documented placeholders for MGRS, SID, and PID when building tile URLs.