---
title: "Grid rank report ready"
method: POST
path: "rankings.gridrank_report_ready"
tags: ["Webhooks/Webhooks", "Webhooks"]
---

# Grid rank report ready

`POST rankings.gridrank_report_ready` (webhook)

**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.

## Headers

- `X-Synup-Signature` string, required

## Payload

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

## Acknowledgement `200`

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

- object

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)