Skip to main content
GET
/
v1
/
queries
curl --request GET \
  --url 'https://api.dune.com/api/v1/queries?limit=20&offset=0' \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>'

{
  "queries": [
    {
      "created_at": "<string>",
      "description": "<string>",
      "id": 123,
      "name": "My Query",
      "owner": "<string>",
      "tags": [
        "<string>"
      ],
      "updated_at": "<string>"
    }
  ],
  "total": 100
}
To access Query endpoints, an Analyst plan or higher is required.
Retrieve a paginated list of queries owned by the account associated with the API key. This endpoint is useful for:
  • Discovering all queries in your account
  • Building custom query management interfaces
  • Auditing query ownership and metadata
  • Syncing query information to external systems

​
Response

The endpoint returns a list of query overview objects containing:
  • id: Unique identifier of the query
  • name: Name of the query
  • description: Description of the query
  • owner: Owner handle (username or team handle)
  • tags: Tags associated with the query
  • created_at: Timestamp of when the query was created
  • updated_at: Timestamp of when the query was last updated
  • total: Total number of queries available (for pagination)

​
Pagination

Use the limit and offset parameters to paginate through large result sets:
  • limit: Number of queries to return per page (default: 20)
  • offset: Number of queries to skip (default: 0)
curl --request GET \
  --url 'https://api.dune.com/api/v1/queries?limit=20&offset=0' \
  --header 'X-DUNE-API-KEY: <x-dune-api-key>'

Headers

​
X-Dune-Api-Key
string
required

API Key for the service

Query Parameters

​
api_key
string

API Key, alternative to using the HTTP header X-Dune-Api-Key

​
limit
integer

Number of queries to return on a page. Default: 20

​
offset
integer

Offset used for pagination. Default: 0

Response

OK

​
queries
object[]

List of queries

​
total
integer

Total number of queries available

Example:

100