ExamplesBulk Download
Get url of the data file to download it - DATA
Example request for the download URL of a bulk report DATA file.
Query parameters
| Parameter | Value | Description |
|---|---|---|
id | adbb9b62-5c08-4142-82e0-b2b575f3e058 | ID of the bulk report to download the file from |
file | DATA | Type of file to download - the dataset file (CSV or JSON) |
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=DATA' \
--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=DATA',
{ 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/data.csv.gz?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=896869274290-compute%40developer.gserviceaccount.com%2F20250627%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20250627T110214Z&X-Goog-Expires=60&X-Goog-SignedHeaders=host&X-Goog-Signature=637aaa8e7a287d311ba9cfb44f38aa74fbb3bd2de00cf293b73065db1c34cd328dfd3e0a1193cfe031942c9ed704552601de18508d315b23104d55fd33b3ad0003f08cb63cb939c71d60c569ffe8b109fe74b2e699f7bd89574d455a2a0d599d485a906b63b735b615788c09a97ea0e4e4817f7d0053897a3c405244ff52f266712a56865135d6a3050f1eef94ce6e7633227a98ce5b9f3d1d951cd080b7f3e031a243d0bfdd15cd2b3379a5d59ecee4e0403962eeae337ff3c89f7ecf756e504e113ac329483ec09e626c676a708aff1711d52e5d3ef22ab7e58557c8ad48c6ca85e901f9a65673207e3508fdc07cc0cbb60faa4733e008cb99bb9135896cef"
}