Skip to main content
GET
Minimum required API key scope: Read. Lists the submissions of the user who created the API key.

Description

Returns the contract decoding submissions made by the user who created the API key, newest first. Use it to track submissions made through Submit Contracts for Decoding or the Dune UI.

Statuses

Filtering

Combine any of blockchain_name, address, project_name, contract_name, and status. Filters are ANDed together.

Pagination

Results are paged with an opaque cursor. Request a page with limit (default 50, maximum 250). When more results exist the response includes next_cursor; pass it back as the cursor parameter to fetch the next page. total is the number of submissions matching the filters across all pages.

Pricing

This is a metadata endpoint and does not consume credits.

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

blockchain_name
string

Filter by blockchain, e.g. ethereum

address
string

Filter by contract address

project_name
string

Filter by project (namespace) name

contract_name
string

Filter by contract name

status
enum<string>

Filter by submission status

Available options:
pending,
approved,
rejected,
processed,
in_progress,
cancelled,
needs_manual_review
limit
integer

Maximum number of submissions to return (default 50, max 250)

cursor
string

Opaque cursor for pagination. Use the value provided on a previous response under next_cursor

Response

OK

next_cursor
string

NextCursor is set when more submissions exist; pass it as the cursor query parameter.

submissions
object[]
total
integer