Global Fishing Watch API
ExamplesBulk Download

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.

Request body

FieldValueDescription
namesar-vessel-detection-example-4-structureIDName of the report
datasetpublic-fixed-infrastructure-data:latestFixed infrastructure dataset
formatCSVOutput format of the report
region.datasetpublic-eez-areasExisting region dataset
region.id8466Argentina EEZ region id
filters["structure_id = 313068"]Filter by a specific structure ID

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-4-structureID",
  "dataset": "public-fixed-infrastructure-data:latest",
  "format": "CSV",
  "region": {
    "dataset": "public-eez-areas",
    "id": 8466
  },
  "filters": ["structure_id = 313068"]
}'

Response

{
    "id": "9d666902-859c-4d39-8422-a215cfda3e8f",
    "dataset": "public-fixed-infrastructure-data:v1.1",
    "name": "fixed-infrastructure-example-4-structureID",
    "filepath": "sar_fixed_infrastructure_202409.csv",
    "filters": [
        "structure_id = 313068"
    ],
    "status": "pending",
    "geom": {
        "type": "dataset",
        "dataset": "public-eez-areas",
        "id": 8466
    },
    "createdAt": "2025-07-01T00:51:24.373Z",
    "updatedAt": "2025-07-01T00:51:24.373Z",
    "ownerId": 385,
    "ownerType": "user-application",
    "format": "CSV",
    "fileSize": null
}