---
title: "GNQL V3 Recall"
method: GET
path: "/v3/gnql/timeseries"
tags: ["Recall"]
---

# GNQL V3 Recall

`GET /v3/gnql/timeseries`

Get hourly GNQL records for a given time range.

## Query parameters

- `query` string, required
- `start` string, date-time
- `end` string, date-time
- `format` 'csv' | 'json'
- `limit` integer
- `offset` integer

## Response `200`

Query successful.

- TimeSeriesResponse — Response object for the timeseries endpoint. The response is a map where keys are time intervals and values are arrays of IP records observed in that interval. Time interval keys are formatted as YYYY-MM-DD-HH (e.g., "2025-01-15-14")

## Other responses

- `206` — Partial content - request partially successful. Due to plan limitations, your request only returned a subset of fields and/or data. Contact sales@greynoise.io to upgrade your plan and unlock full results.
- `400` — Bad request - request syntax is invalid for the specified endpoint. Verify request syntax and try again.
- `401` — Unauthorized. Please check your API key.
- `429` — Too many requests. You've hit the rate-limit.

---

[API](https://skmtc.dev/greynoise/apis/greynoise-api.md) · [All operations](https://skmtc.dev/greynoise/apis/greynoise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greynoise/greynoise-api/revisions/30942574656d/schema)