ExamplesBulk Download
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.
Request body
| Field | Value | Description |
|---|---|---|
name | sar-vessel-detection-example-medium | 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 = 'medium'"] | Filter by medium-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-medium",
"dataset": "public-fixed-infrastructure-data:latest",
"format": "CSV",
"region": {
"dataset": "public-eez-areas",
"id": 8466
},
"filters": ["label_confidence = '\''medium'\''"]
}'// 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-medium',
dataset: 'public-fixed-infrastructure-data:latest',
format: 'CSV',
region: {
dataset: 'public-eez-areas',
id: 8466,
},
filters: ["label_confidence = 'medium'"],
}),
})
const data = await res.json()Response
{
"id": "f32c36b5-99e2-45b7-a106-95dfa22bd7be",
"dataset": "public-fixed-infrastructure-data:v1.1",
"name": "sar-vessel-detection-example-medium",
"filepath": "sar_fixed_infrastructure_202409.csv",
"filters": [
"label_confidence = 'medium'"
],
"status": "pending",
"geom": {
"type": "dataset",
"dataset": "public-eez-areas",
"id": 8466
},
"createdAt": "2025-06-27T10:17:53.740Z",
"updatedAt": "2025-06-27T10:17:53.740Z",
"ownerId": 509,
"ownerType": "user-application",
"format": "CSV",
"fileSize": null
}Generate report for Argentina EEZ with filter by label_confidence = 'high'
Example bulk report request for the Argentina EEZ, filtered to high label confidence detections.
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.