{"uid":"cap_qrirmI-FeLOAkgxAlmM4u","slug":"blockscout-smart-contract-audit-report-submission-6ff17241","name":"Blockscout Smart Contract Audit Report Submission","description":"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","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/smart-contracts/%7Baddress_hash_param%7D/audit-reports","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"type":"json","example":{"items":[{"audit_report_url":"string","audit_company_name":"string","audit_publish_date":"string"}],"message":"string","next_page_params":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GUqIGlY9JmPnvc84E5Fsm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submit a smart contract security audit report for a specific contract address on a given blockchain network via Blockscout","exampleAgentPrompt":"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).","exampleUseCases":[{"title":"DeFi protocol publishing audit proof","prompt":"Register a new audit report on Blockscout for our DeFi contract at 0xDEADBEEF...1234 on Polygon (chain ID 137) — Hacken performed the audit, it was published on 2024-01-20, the report is at https://hacken.io/audits/mydefi, I'm the project owner, submitter is Bob Lee at bob@mydefi.xyz."},{"title":"Security firm linking client audit","prompt":"As the auditor at SlowMist, submit an audit report for the contract 0x5678...ABCD on BNB Chain (chain ID 56) — report URL is https://slowmist.com/reports/clienttoken, published 2023-11-10, project name is ClientToken, and my email is auditor@slowmist.com. I am not the project owner."},{"title":"Community member flagging audited contract","prompt":"Add a public audit report to Blockscout for the NFT contract 0x9999...AAAA on Arbitrum (chain ID 42161) — the audit was done by OpenZeppelin on 2024-05-01 and posted at https://openzeppelin.com/audits/nftproject. My name is Charlie Dev and I want to leave a comment: 'Full audit passed with no critical issues'."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T00:55:48.549Z","isFirstParty":false}