# Grid rank report ready

**Event:** `rankings.gridrank_report_ready`

**Event name:** `rankings.gridrank_report_ready`

A Grid (local-rank map) report finished generating. Scope: location-scoped. Delivered as a signed HTTP POST to your Webhooks URL.

Source: https://developer.synup.com/webhooks/rankings-gridrank-report-ready

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Synup-Signature` | string | required | sha256=base64(HMAC-SHA256(signing_secret, raw_request_body)). Verify with your signing secret before processing; reject on mismatch. |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `event` | string | optional | Dotted event name. |
| `timestamp` | string | optional | ISO-8601 UTC time the event was emitted. |
| `account_id` | integer | optional | Synup account the event belongs to. |
| `location_id` | string | optional | Numeric string for location-scoped events; null for brand-scoped events. |
| `data` | object | optional |  |
| `data.report_id` | string | optional | Report UUID. |
| `data.engine` | string | optional | Grid vendor: "GEORANKER", "LOCALFALCON", or "AWS". |
| `data.snapshot_date` | string | optional | Completion date, YYYY-MM-DD. |
| `data.geo` | object | optional | Grid geometry: latitude, longitude, grid_size, grid_distance, grid_distance_unit. |
| `data.average_rank` | number | optional | Average rank across all grid points. |
| `data.top_one_share` | number | optional | Share of points ranked #1. |
| `data.top_two_share` | number | optional | Share of points ranked in the top two. |

## Responses

| Status | Description |
| --- | --- |
| `200` | Your endpoint acknowledges receipt with any 2xx. A non-2xx response or a timeout (>10s) is treated as a failed delivery. |