WWaterChainwaterchain.tech ↗
DEVELOPER PLATFORM · API V1

Build on WaterChain.

Connect applications to trusted credentials, evidence and blockchain-backed verification through a production developer API.

Quick Start →API Reference
CHECKING…api.waterchain.tech
v1Production API
Avalanche C-ChainChain ID 43114
HTTPS / TLSEncrypted transport
01

Quickstart

Make your first authenticated request in minutes.

AUTHENTICATION

Bearer API keys

Protected endpoints use a Bearer API key. Keep production secrets server-side and never hard-code them into public applications.

Authorization: Bearer YOUR_API_KEY
FIRST REQUEST

Check API health

The health endpoint is public and does not require a key.

GET https://api.waterchain.tech/v1/health
02

API Reference

Production endpoints exposed by WaterChain API v1.

GET/v1/health

Returns service status, network, chain ID, contract and RPC state.

PUBLIC
GET/v1/certificates

Lists certificate records with pagination.

certificate:read
GET/v1/certificates/{certificateNo}

Retrieves a certificate record by its canonical WaterChain certificate number.

certificate:read
GET/v1/verify/{certificateNo}

Returns a machine-readable verification record for integrations.

certificate:verify
03

API Explorer

Run live requests against the production API. Keys are used only for the current request and are never stored.

GEThttps://api.waterchain.tech/v1/health
LIVE RESPONSEREADY
Select an endpoint and run the request.
04

Guides & Security

Patterns for production integrations.

SERVER-SIDE SECRETS

Never expose API keys

Store production credentials in your server environment or secret manager. Do not commit them to source control or browser JavaScript.

VERIFICATION

Verify before trusting

Use the verification endpoint to reconcile certificate identity and evidence before accepting a credential in your workflow.

ERRORS

Predictable responses

400 Invalid Request · 401 Unauthorized · 403 Forbidden · 404 Not Found · 409 Conflict · 422 Invalid SHA-256 · 429 Rate Limited · 500 Internal Error.

TRUST LAYER

Blockchain-backed state

WaterChain API connects application workflows to Blockcerts, evidence and Avalanche C-Chain state.