---
title: "Check verification job status"
method: GET
path: "/v2/verify/{verificationId}"
tags: ["Verification Jobs"]
---

# Check verification job status

`GET /v2/verify/{verificationId}`

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}`

## Path parameters

- `verificationId` string, uuid, required

## Response `200`

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.

- object
  - `isJobCompleted` boolean, required
  - `verificationId` string, uuid, required
  - `error` object — Optional, when the verification fails for some reason.
    - `customCode` string, required — A string token to indicate the reason of the error
    - `message` string, required — The reasoning of the error
    - `errorId` string, uuid, required
    - `recompiledCreationCode` string
    - `recompiledRuntimeCode` string
    - `onchainCreationCode` string
    - `onchainRuntimeCode` string
    - `creationTransactionHash` string
    - `errorData` object
  - `jobStartTime` string, date-time
  - `jobFinishTime` string
  - `compilationTime` string — Time it took to compile the contract on the server in milliseconds.
  - `externalVerifications` object — Links to external verification status endpoints on Etherscan-alike services.
    - `etherscan` object — Status metadata for the verification job mirrored on an external explorer API.
      - `verificationId` string — Identifier returned by the external verifier when the job was created.
      - `error` string — Error message returned by the external verifier. Present when the verification failed.
      - `statusUrl` string, uri — Direct URL to query the verification status from the explorer API.
      - `explorerUrl` string, uri — Direct URL to the block explorer page for the contract
    - `blockscout` object — Status metadata for the verification job mirrored on an external explorer API.
      - `verificationId` string — Identifier returned by the external verifier when the job was created.
      - `error` string — Error message returned by the external verifier. Present when the verification failed.
      - `statusUrl` string, uri — Direct URL to query the verification status from the explorer API.
      - `explorerUrl` string, uri — Direct URL to the block explorer page for the contract
    - `routescan` object — Status metadata for the verification job mirrored on an external explorer API.
      - `verificationId` string — Identifier returned by the external verifier when the job was created.
      - `error` string — Error message returned by the external verifier. Present when the verification failed.
      - `statusUrl` string, uri — Direct URL to query the verification status from the explorer API.
      - `explorerUrl` string, uri — Direct URL to the block explorer page for the contract
  - `contract` object
    - `match` string, required
    - `creationMatch` string, required
    - `runtimeMatch` string, required
    - `chainId` string, required
    - `address` string, required — Contract Address in hex string. Can be checksummed or not (i.e. can contain capital letters)
    - `verifiedAt` string, date-time
    - `matchId` string
    - `name` string — Contract name (Tempo extension)

## Other responses

- `404` — The job is not found with this ID

## Changes

- **2026-01-23** `04a1e81cee76` — 1 info
  - added the optional property `allOf[subschema #2]/contract/name` to the response with the `200` status
- **2025-12-17** `f02ddb386819` — 1 warning
  - removed the optional property `allOf[subschema #2]/contract/name` from the response with the `200` status

[Change history](https://skmtc.dev/tempoxyz/apis/contract-verification-api/changes/v2/verify/:verificationId/get.md)

---

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