Live on Base with Ewance

See the certificates
Sign in
API ReferenceReferenceBatches

List batches

GET
/batches

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token in the Authorization header. Key prefix determines environment: lrn_test_ → Base Sepolia, lrn_live_ → Base mainnet.

In: header

Query Parameters

cursor?string

Opaque pagination cursor from the previous response.

limit?integer

Page size (1–100, default 25).

Default25
Range1 <= value <= 100
status?string

Filter by batch status.

Value in"pending" | "signed" | "anchored" | "failed"

Response Body

application/json

application/json

curl -X GET "https://api.learncoin.me/v1/batches"
{
  "data": [
    {
      "id": "string",
      "status": "pending",
      "credentials_count": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "anchored_at": "2019-08-24T14:15:22Z",
      "environment": "test",
      "merkle_root": "0x7c2f91a8…",
      "anchor_transaction": {
        "chain": "base-mainnet",
        "hash": "0xabcd…ef12",
        "block_number": 0,
        "explorer_url": "http://example.com"
      },
      "credentials": [
        {
          "id": "string",
          "recipient_id": "string",
          "verify_url": "http://example.com"
        }
      ],
      "error": "string"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}
{
  "error": {
    "code": "credential_not_found",
    "message": "string",
    "request_id": "req_01HXYZABCDEF"
  }
}

TypeScript types

Canonical TypeScript types for the LearnCoin API — copy these into your codebase for end-to-end type safety.

Create a batch of credentials

Submit one or more credentials for signing and anchoring. The endpoint returns immediately; signing + anchoring complete asynchronously, typically within 60 seconds on testnet. Subscribe to `batch.anchored` webhooks rather than polling.