# Blockscout Smart Contract Audit Report Submission

> Blockscout Smart Contract Audit Report Submission is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-12).

Submit a smart contract security audit report for a specific contract address on a given blockchain network via Blockscout

## Facts

- Endpoint: POST https://api.blockscout.com/%7Bchain_id%7D/api/v2/smart-contracts/%7Baddress_hash_param%7D/audit-reports
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-smart-contract-audit-report-submission-6ff17241
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qrirmI-FeLOAkgxAlmM4u

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-smart-contract-audit-report-submission-6ff17241 -d '<json body>'
```

Example prompt: Submit an audit report for the smart contract at 0xAbC123...def on Ethereum (chain ID 1) — the audit was done by CertiK, published on 2024-03-15, and the report URL is https://certik.com/projects/myprotocol. I'm the project owner and my name is Alice Smith (alice@myprotocol.io).

## When to prefer this

Use this endpoint when you need to attach a security audit report to a specific smart contract on Blockscout's explorer, making the audit visible to users browsing that contract. Prefer this over generic data storage when you want the audit to appear natively in the Blockscout UI alongside verified contract source code. Best suited for project owners, security firms, or community contributors wanting to surface audit provenance on-chain via a public blockchain explorer.

## Known failure modes

- Invalid contract address hash — 404 or validation error if address doesn't exist on chain
- Invalid chain_id — endpoint returns error if unsupported or malformed chain identifier
- Missing required fields (e.g. audit_report_url, audit_company_name) — 422 unprocessable entity
- Invalid date format for audit_publish_date — must be ISO date string (YYYY-MM-DD)
- Duplicate submission — same audit URL may already be registered for the contract
- Payment failure — x402 micropayment of $0.002 USDC not fulfilled, returns 402 status
- Malformed or unreachable audit_report_url — may fail validation

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns a JSON object containing a list of audit report items (each with audit_report_url, audit_company_name, and audit_publish_date), a status message, and optional next_page_params for paginated results. Confirms the audit report was successfully submitted and associated with the specified smart contract address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "comment": {
   "type": "string",
   "nullable": true,
   "x-struct": null,
   "x-validate": null
  },
  "project_url": {
   "type": "string",
   "x-struct": null,
   "x-validate": null
  },
  "project_name": {
   "type": "string",
   "x-struct": null,
   "x-validate": null
  },
  "submitter_name": {
   "type": "string",
   "x-struct": null,
   "x-validate": null
  },
  "submitter_email": {
   "type": "string",
   "x-struct": null,
   "x-validate": null
  },
  "audit_report_url": {
   "type": "string",
   "x-struct": null,
   "x-validate": null
  },
  "is_project_owner": {
   "type": "boolean",
   "x-struct": null,
   "x-validate": null
  },
  "audit_company_name": {
   "type": "string",
   "x-struct": null,
   "x-validate": null
  },
  "audit_publish_date": {
   "type": "string",
   "format": "date",
   "x-struct": null,
   "x-validate": null
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "audit_report_url": "string",
    "audit_company_name": "string",
    "audit_publish_date": "string"
   }
  ],
  "message": "string",
  "next_page_params": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-smart-contract-audit-report-submission-6ff17241/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)