Get url of the data file to download it - README

Example request for the download URL of a bulk report README file, the metadata documentation for the dataset.

Query parameters

Parameter	Value	Description
`id`	`adbb9b62-5c08-4142-82e0-b2b575f3e058`	ID of the bulk report to download the file from
`file`	`README`	Type of file to download - metadata documentation file

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=README' \
--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=README',
  { 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/README.md?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=896869274290-compute%40developer.gserviceaccount.com%2F20250627%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20250627T110204Z&X-Goog-Expires=60&X-Goog-SignedHeaders=host&X-Goog-Signature=2b7ed1b82af29747bfe00d2abf745a2d20f6909c4548f1aeebc8f2f51e0be335872622423ee888b25daad93cb4871bc398f4c1ec279febaaf2cf16197ba3044f0d28443c05d197e46cddfcfac3401958fb87efc3d04c9ea9761dbff6567bf53a7ec634a44425e1160ad31552e7126b257441fc047ceb95a11e167620cb8b99232942afa28c08a5c414981dbef3681ee3868d1df7655d2c6a6c5123f9db3a27a73d15cd976d7508bac8de9c5bc865e6ed55dd62805b0f2a87c494484a60e521335af80711f7fce207fe25db54d5fd7efedbf46aa4119d0d539d995a575e758079ba771b07a7ed6e8fe93dfaaefbc519d45855b1f44df21307bb0ecc036f7bd36b"
}