Skip to main content
GET
Get a project's Etherscan card

Authorizations

Authorization
string
header
required

Authorization: Bearer <key>.

For the project and card routes, the key is an API key belonging to an onboarded integrator or to an active audit provider. The publishing routes accept only an audit provider's credential. Sending no Authorization header produces 401; sending one that is not recognised produces 403.

Query Parameters

domain
string
slug
string
chain
string

One of the chain names below, or a decimal EVM chain id (1, 56, 8453...). A chain Trustblock does not record - an unknown id or name - answers 200 with isFound: false (no card), never an error.

Example:

"ethereum"

address
string

Response

A card, found or not found.

isFound
boolean
required

False for the "No audit on Trustblock" card: an unknown project, a project with no audit, or a chain Trustblock does not record. imageUrl, centerText and statusColor are still sent; the other card fields are then absent.

imageUrl
string
required
centerText
string
required

One short line. The worst state wins: "Incident 3 Aug 2026" (red), "2 open critical findings" (red), "2 criticals acknowledged, not fixed" (orange), "No open critical findings" (green), or "No audit on Trustblock" (orange, isFound: false).

statusColor
enum<string>
required

Hex colour for the card, matching its status.

Available options:
#F08D3C,
#E84353,
#67A22F
extra
object
required

Present on every response, including errors.

status
boolean

The same value as isFound, under the name Etherscan's multichain template reads.

contractLine
string

Present only when the request named a contract (chain + address) and an audit's own scope names that address: "This address was in the scope of the Hacken audit of 9 Sep 2026", or "This address was in the scope of 2 audits; latest: Hacken, 8 May 2026". Absent otherwise, never null.

topLeftText
string
topRightText
string

For example "Last audit Aug 2026".

centerText2
string

For example "3 audits by 2 firms". Plain text.

centerText3
string
iconUrl
string
url
string

The project's page on Trustblock.

isAIScan
boolean