> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoal.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Radar

> Get all radar events

Radar events are structured summaries of noteworthy activity across the digital asset ecosystem — partnerships, product launches, regulatory developments, security incidents, and more. Each event includes the organizations involved, a human-readable summary, bullet points, and the original source posts.

The live API returns both canonical field names and legacy compatibility fields during the schema transition. New integrations should build against the canonical names:

* `summary`
* `bullets`
* `owners`
* `participants`
* `evidence`
* `latestEvidenceTimestamp`
* `significance`

Use this endpoint to pull a chronological feed of all radar events since a given timestamp.

<Note>
  This is a bulk feed endpoint intended for higher-tier polling and export workflows. For most applications, prefer `/v1/radar/byOrganizationId` or `/v1/radar/byCategory`.
</Note>

## Query Parameters

* `since` (string, **required**) — ISO 8601 timestamp. Only return events newer than this time. See [Polling Guide](/guides/polling).
* `limit` (integer, default: 25, max: 25)
* `offset` (integer, default: 0, max: 250)
* `cursor` (string, optional) — Opaque cursor token from a previous `next_cursor` response. When provided, `since` is required and `offset` is ignored.

<Warning>
  The `since` parameter is required. Requests without it return `400`:

  ```json theme={null}
  { "error": "The 'since' parameter is required. Use an ISO 8601 timestamp (e.g. 2026-02-01T00:00:00Z)." }
  ```

  Invalid timestamps (e.g. `since=garbage`) are also rejected with `400`.

  This endpoint is for recent monitoring, not deep historical replay. The `since` timestamp cannot be older than 7 days. For deeper history, use scoped routes or contact Shoal about export access.
</Warning>

### Request

```bash cURL theme={null}
curl -X GET "https://api.shoal.xyz/v1/radar/all?since=2026-04-04T00:00:00Z&limit=25&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response (200)

```json theme={null}
{
  "limit": 25,
  "offset": 0,
  "since": "2026-04-04T00:00:00Z",
  "next_cursor": "eyJ0cyI6IjIwMjYtMDItMjhUMDY6MTg6NDQuMDAwWiIsImlkIjo2NTB9",
  "data": [
    {
      "id": 650,
      "title": "Event Title",
      "eventCategory": "partnership",
      "eventSubcategory": "acquisition",
      "summary": "Summary of the event.",
      "bullets": ["Bullet point 1.", "Bullet point 2."],
      "owners": [
        {
          "id": 968,
          "label": "Organization Name",
          "type": "project",
          "aliases": ["Alias"]
        }
      ],
      "participants": [
        {
          "id": 205,
          "label": "Participant Name",
          "type": "government_institution",
          "aliases": ["Alias"]
        }
      ],
      "evidence": [
        {
          "id": 46970,
          "content": "Post content",
          "url": "https://x.com/...",
          "timestamp": "2026-02-28T06:18:44+00:00"
        }
      ],
      "latestEvidenceTimestamp": "2026-02-28T06:18:44.000Z",
      "significance": 7.01,
      "globalSummary": "Summary of the event.",
      "bulletSummary": ["Bullet point 1.", "Bullet point 2."],
      "eventOwner": [
        {
          "id": 968,
          "label": "Organization Name",
          "type": "project",
          "aliases": ["Alias"]
        }
      ],
      "eventParticipants": [
        {
          "id": 205,
          "label": "Participant Name",
          "type": "government_institution",
          "aliases": ["Alias"]
        }
      ],
      "posts": [
        {
          "id": 46970,
          "content": "Post content",
          "url": "https://x.com/...",
          "timestamp": "2026-02-28T06:18:44+00:00"
        }
      ],
      "latestPostTimestamp": "2026-02-28T06:18:44.000Z",
      "signal": 7.01
    }
  ]
}
```

Legacy compatibility fields are still present for existing clients:

* `globalSummary` -> `summary`
* `bulletSummary` -> `bullets`
* `eventOwner` -> `owners`
* `eventParticipants` -> `participants`
* `posts` -> `evidence`
* `latestPostTimestamp` -> `latestEvidenceTimestamp`
* `signal` -> `significance`