DUdune

List contract submissions

Changed on

List the contract decoding submissions made by the authenticated account, newest first, with optional filters. Use this to track the status of submissions made via POST /v1/contracts/decode. Page with limit and the next_cursor returned by the previous response.

get/v1/contracts/submissions

Request

  • Base URL
    https://api.dune.com/api
  • URL
    https://api.dune.com/api/v1/contracts/submissions
  • Auth
    none declared. Required headers: X-Dune-Api-Key

Query parameters

api_keystring

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

blockchain_namestring

Filter by blockchain, e.g. ethereum

addressstring

Filter by contract address

project_namestring

Filter by project (namespace) name

contract_namestring

Filter by contract name

status'pending' | 'approved' | 'rejected' | 'processed' | 'in_progress' | 'cancelled' | 'needs_manual_review'

Filter by submission status

limitinteger

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

cursorstring

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

Headers

X-Dune-Api-Keystring required

API Key for the service

Response

OK

next_cursorstring

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

totalinteger

Example response

{
  "submissions": [
    {
      "blockchain_name": "ethereum",
      "created_at": "2024-12-20T11:04:18.724658237Z",
      "updated_at": "2024-12-20T11:04:18.724658237Z"
    }
  ]
}

Changes