ExamplesBulk Download
Generate report for Argentina EEZ with filter by label_confidence = 'low'
Example bulk report request for the Argentina EEZ, filtered to low label confidence detections.
Request body
| Field | Value | Description |
|---|---|---|
name | sar-vessel-detection-example-3-low | Name of the report |
dataset | public-fixed-infrastructure-data:latest | Fixed infrastructure dataset |
format | CSV | Output format of the report |
region.dataset | public-eez-areas | Existing region dataset |
region.id | 8466 | Argentina EEZ region id |
filters | ["label_confidence = 'low'"] | Filter by low-confidence detections |
Request
# Make sure to replace [TOKEN] with your API Access Token.
curl --location 'https://gateway.api.globalfishingwatch.org/v3/bulk-reports' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN' \
--data '{
"name": "sar-vessel-detection-example-3-low",
"dataset": "public-fixed-infrastructure-data:latest",
"format": "CSV",
"region": {
"dataset": "public-eez-areas",
"id": 8466
},
"filters": ["label_confidence = '\''low'\''"]
}'// Make sure to replace [TOKEN] with your API Access Token.
const res = await fetch('https://gateway.api.globalfishingwatch.org/v3/bulk-reports', {
method: 'POST',
headers: {
Authorization: 'Bearer [TOKEN]',
'Content-Type': 'application/json',
},
body: JSON.stringify({
name: 'sar-vessel-detection-example-3-low',
dataset: 'public-fixed-infrastructure-data:latest',
format: 'CSV',
region: {
dataset: 'public-eez-areas',
id: 8466,
},
filters: ["label_confidence = 'low'"],
}),
})
const data = await res.json()Response
{
"id": "322420b5-f7e8-4724-83f3-f00771a25e87",
"dataset": "public-fixed-infrastructure-data:v1.1",
"name": "fixed-infrastructure-example-3-low",
"filepath": "sar_fixed_infrastructure_202409.csv",
"filters": [
"label_confidence = 'low'"
],
"status": "pending",
"geom": {
"type": "dataset",
"dataset": "public-eez-areas",
"id": 8466
},
"createdAt": "2025-07-01T00:49:18.176Z",
"updatedAt": "2025-07-01T00:49:18.176Z",
"ownerId": 385,
"ownerType": "user-application",
"format": "CSV",
"fileSize": null
}Generate report for Argentina EEZ with filter by label_confidence = 'medium'
Example bulk report request for the Argentina EEZ, filtered to medium label confidence detections.
Generate report for Argentina EEZ with filter by structure_id = 313068
Example bulk report request for the Argentina EEZ, filtered to a single structure id.