ExamplesBulk Download
Get url of the data file to download it - GEOM
Example request for the download URL of a bulk report GEOM file.
Query parameters
| Parameter | Value | Description |
|---|---|---|
id | adbb9b62-5c08-4142-82e0-b2b575f3e058 | ID of the bulk report to download the file from |
file | GEOM | Type of file to download - the region geometry in GeoJSON format |
Request
# Make sure to replace [TOKEN] with your API Access Token.
curl --location 'https://gateway.api.globalfishingwatch.org/v3/bulk-reports/adbb9b62-5c08-4142-82e0-b2b575f3e058/download-file-url?file=GEOM' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN'// Make sure to replace [TOKEN] with your API Access Token.
const res = await fetch(
'https://gateway.api.globalfishingwatch.org/v3/bulk-reports/adbb9b62-5c08-4142-82e0-b2b575f3e058/download-file-url?file=GEOM',
{ headers: { Authorization: 'Bearer [TOKEN]' } }
)
const data = await res.json()Response
{
"url": "https://storage.googleapis.com/api-bulk-release-us-central1/adbb9b62-5c08-4142-82e0-b2b575f3e058/geom.geojson?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=896869274290-compute%40developer.gserviceaccount.com%2F20250627%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20250627T110254Z&X-Goog-Expires=60&X-Goog-SignedHeaders=host&X-Goog-Signature=0401eb1030fe5c0ff506317817e138bcbb39d8f87f59fc288ca6f33533aa28bd73caf4d13e0210e392e663be069b758aeeb42409a81487850e4fe4b4735e6a641095ad1f972ea8c3eb94714e71a93972ddd90303550bc74375d8ee1d362ee4deb5be88cb002b62762e7371e9f4947e83ceca456a79f888be7295c9d2ec3830d853fe7aea72101b79d1fb3032710268042718fb9ee43e8b0bc92875dfb65ebe2a0d2931ac635eac9c6aee4c7b75121bc1e043fc330d36352d0c1d40150cc5269804024363c5369c1cd2ec0bfa05e4335012b6ff1a9262a8880bf2535a3b3f8faa5f852f67ce8b9d8b3a69215d7e1fcffc1122db8789ae1a6a520bd94000c07f2c"
}