Submit up to 100 hashes in one call
Every item is checked first. On Free, if the new items would pass this month's 100, nothing is recorded and the reply says how many remain (429). On Developer and Platform, proofs past the allowance are recorded and billed at $0.01 each. The new proofs are written in one transaction and anchoring starts. An item whose external_id already exists on the account comes back as exists with the existing proof and costs nothing.
Request
- Base URL: https://proofledger.io
- URL: https://proofledger.io/api/v1/proofs/batch
- Auth: HTTP bearer
Headers
Optional. Any unique string, 1 to 200 printable ASCII characters, no spaces. A resend with the same key and the same body within 24 hours returns the stored 2xx response (same status, same JSON) with Idempotent-Replayed: true and runs nothing twice. The same key with a different body is refused with 422; a duplicate that arrives while the first request is still running gets 409. Only 2xx responses are stored, so after a 4xx the same key accepts a corrected body. Scoped to your account and to the route.
Request body
Response
Nothing new to create (every valid item already existed).
Example response
{
"items": [
{
"proof": {
"status": "approved",
"certificate_url": "https://proofledger.io/cert/42",
"verification_url": "https://proofledger.io/verify.html?hash=a1b2c3..."
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.