# Get Bulk Report status by ID (/docs/v3/bulk-download/get-bulk-report-id)



This endpoint allows you to retrieve metadata and status of a previously created report using its unique report ID. Use this endpoint to check the current status of a bulk report. Depending on the complexity and size of your request (e.g. large region, long time range), generating the report can take several minutes to several hours. We recommend polling this endpoint periodically to monitor the report’s progress.

### **EXAMPLE: Get bulk report by id** [#example-get-bulk-report-by-id]

<Tabs items="['cURL', 'JavaScript']">
  <Tab value="cURL">
    ```shell
    curl --location 'https://gateway.api.globalfishingwatch.org/v3/bulk-reports/adbb9b62-5c08-4142-82e0-b2b575f3e058' \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer TOKEN'
    ```
  </Tab>

  <Tab value="JavaScript">
    ```js
    // 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',
      { headers: { Authorization: 'Bearer [TOKEN]' } }
    )
    const data = await res.json()
    ```
  </Tab>
</Tabs>

> **EXAMPLE: RESPONSE - Get bulk report by id**

```shell
{
    "id": "adbb9b62-5c08-4142-82e0-b2b575f3e058",
    "dataset": "public-fixed-infrastructure-data:v1.1",
    "name": "sar-vessel-detection-example-1",
    "filepath": "sar_fixed_infrastructure_202409.csv",
    "filters": [
        "label = 'oil'",
        "structure_start_date between '2020-01-01' and '2025-01-01' "
    ],
    "status": "done",
    "geom": {
        "id": 8466,
        "type": "dataset",
        "dataset": "public-eez-areas"
    },
    "createdAt": "2025-06-27T06:43:35.571Z",
    "updatedAt": "2025-06-27T06:43:35.571Z",
    "ownerId": 509,
    "ownerType": "user-application",
    "format": "CSV",
    "fileSize": 1207
}
```

### Get Bulk Report by ID - Specifications [#get-bulk-report-by-id---specifications]

<OpenAPIPage
  document="apiv3"
  operations="[
  {
    path: '/api/v3/bulk-reports/{id}',
    method: 'get',
  },
]"
  hasHead="false"
/>

### Get Bulk Report by ID - Response fields [#get-bulk-report-by-id---response-fields]

Returns the same structure as the response from [Create Bulk Report](/docs/v3/bulk-download/create-bulk-report#bulk-report---response-fields), including fields such as status, name, createdAt, filters, and more.