Developer API · v1

Put certificate verification inside your product.

Submit a COA link, file, or report ID. Receive the certificate, its normalized identity, reported results, testing panel, and exact issuer-verification state.

01 / Endpoints

Verify documents. Retrieve the evidence.

POST/api/v1/coa/verify-url

Fetch a public certificate URL, read the document, check the indexed corpus, and query a supported laboratory record.

POST/api/v1/coa/verify-file

Upload a PDF or image for the same certificate extraction and verification workflow.

POST/api/v1/coa/verify-record

Resolve an exact report ID or public verifier code and return the indexed certificate document when available.

GET/api/v1/coa/vendors

List vendors with certificate feeds and current public record counts.

GET/api/v1/coa/vendors/{vendor_id}

Read the complete current PeptidePrices certificate feed for one vendor.

02 / MCP for AI agents

Give an agent the evidence, not a scraped answer.

The public Streamable HTTP endpoint is read-only and rate-limited. Its tools return structured certificate fields, explicit evidence states, the physical-vial boundary, and inspectable PeptidePrices and laboratory links.

MCP configuration
{
  "mcpServers": {
    "peptideprices-coa": {
      "type": "http",
      "url": "https://api.peptideprices.net/mcp/"
    }
  }
}
verify_coa_url

Check one public COA or laboratory-verifier link.

verify_coa_record

Resolve an exact report ID, search code, or access code.

search_certificates

Find records by vendor, compound, strength, lot, lab, state, or date.

get_certificate

Retrieve one full certificate record and its inspectable sources.

list_vendor_certificates

Read the broadest first-party certificate feed for one vendor.

compare_vendor_coverage

Compare certificate volume, labs, compounds, and states.

get_coa_library_summary

Read current corpus totals and supported lab workflows.

Questions this endpoint is built to answer

Verify one certificate

Does the issuing laboratory's public record match this COA, and what exactly was reported?

Find exact product evidence

Which certificates match this vendor, compound, labeled strength, and lot without substituting a nearby record?

Compare documented coverage

How do two vendors' indexed certificate volumes, laboratories, compounds, and verification states differ?

Each answer can cite the filtered PeptidePrices library, the retained certificate, and the exact official laboratory record when that record is public. A missing or blocked lookup stays unresolved; it never silently becomes a counterfeit finding.

03 / First REST request

Verify a public certificate URL.

cURL
curl -X POST 'https://api.peptideprices.net/api/v1/coa/verify-url' \
  -H 'X-PeptidePrices-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://vendor.example/certificates/report.pdf"}'

04 / Vendor widget

Add the checker without rebuilding it.

The widget is an open client. PeptidePrices continues to produce the result, so the host vendor cannot replace an unresolved lookup with a verified label.

HTML
<script src="https://peptideprices.net/widgets/coa-checker.js"
  data-vendor="Your Vendor Name"
  data-max-width="760px"></script>

05 / REST access

Get a revocable API key.

06 / Evidence contract

The scope stays attached to every result.

  • An issuer match confirms the laboratory record for the submitted certificate.
  • Vendor attribution is returned separately and requires an exact documented relationship.
  • A missing record, blocked portal, timeout, or unsupported laboratory remains unresolved.
  • Physical-vial chain of custody is always a separate conclusion.
Search the public COA library →