v1

latestOpenAPI 3.1.02026-07-17373221.0 KB

Verification Jobs

Check verification job status

Endpoint to get the status of a verification job.

Jobs that have been pending for more than 5 minutes are considered stale and will be automatically expired with a timeout error code when polled.

Alternatively you can directly check the verification status of a contract with with chainId+address at GET /v2/contract/{chainId}/{address}

get/v2/verify/{verificationId}

Path parameters

verificationIdstring uuid required

Example:550e8400-e29b-41d4-a716-446655440000

Verification Job ID returned from the server for a verification request.

Response

The verification job completed either with success or failure. This endpoint returns 200 even if the verification job fails. Check the contract.match field and error for verification statuses.

If the job is not completed yet (i.e. pending), the isJobCompleted will be false.

isJobCompletedboolean required

verificationIdstring uuid required

jobStartTimestring date-time

jobFinishTimestring

compilationTimestring

Time it took to compile the contract on the server in milliseconds.

Example response

{
  "error": {
    "customCode": "unsupported_chain",
    "message": "The chain with chainId 9429413 is not supported",
    "errorId": "1ac6b91a-0605-4459-93dc-18f210a70192"
  },
  "compilationTime": "1333",
  "externalVerifications": {
    "etherscan": {
      "verificationId": "x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi",
      "error": "NOTOK: Max rate limit reached",
      "statusUrl": "https://api.etherscan.io/v2/api?chainid=1&module=contract&action=checkverifystatus&guid=x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi",
      "explorerUrl": "https://etherscan.io/address/0x0D41E0B7bbdEBDBc684020dcb64ADe76C0338222#code"
    },
    "blockscout": {
      "verificationId": "x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi",
      "error": "NOTOK: Max rate limit reached",
      "statusUrl": "https://api.etherscan.io/v2/api?chainid=1&module=contract&action=checkverifystatus&guid=x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi",
      "explorerUrl": "https://etherscan.io/address/0x0D41E0B7bbdEBDBc684020dcb64ADe76C0338222#code"
    },
    "routescan": {
      "verificationId": "x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi",
      "error": "NOTOK: Max rate limit reached",
      "statusUrl": "https://api.etherscan.io/v2/api?chainid=1&module=contract&action=checkverifystatus&guid=x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi",
      "explorerUrl": "https://etherscan.io/address/0x0D41E0B7bbdEBDBc684020dcb64ADe76C0338222#code"
    }
  },
  "contract": {
    "chainId": "42431",
    "address": "0xDFEBAd708F803af22e81044aD228Ff77C83C935c",
    "verifiedAt": "2024-07-24T12:00:00Z",
    "matchId": "3266227",
    "name": "MyContract"
  }
}