Andamio Logo
Issuer

Integrate via API

How Andamio Issuer plugs into the systems you already run

Preview. The Issuer API surface is taking shape: the write plane is live on preprod and the read-plane endpoint list is locked, with response payloads still in progress. Endpoint details and schemas will be published here as they settle.

Andamio Issuer exposes a single, versioned API surface that you call from the systems you already run. It builds and submits the on-chain transactions for you, so your integration is ordinary REST: you make a request, Andamio handles the chain.

The shape

One namespace: /issuer/v1/. Two kinds of endpoint:

  • Write (POST) builds a sponsored transaction that Andamio signs, sponsors, and submits on the caller's behalf. No wallets, no ADA, no signing on your side.
  • Read (GET) returns on-chain data, scoped server-side to the caller.

Authentication. The tenant is your organization, identified by an X-API-Key. The caller is the authenticated person within it, acting in one of four roles: User, Admin, Teacher, or Learner.

What you can do

The write plane covers the full credential lifecycle: create user accounts, create courses, manage teachers, define and remove credentials, submit and approve evidence, and claim earned credentials.

The read plane covers the data you build on: course catalogs and structure, teachers and learners, and per-person views of the credentials someone holds, their submissions, and the reviews awaiting them.

How it relates to the Andamio API

Issuer is a higher-level surface built on the Andamio API. The API gives developers the full protocol; Issuer narrows it to the credentialing job and removes the blockchain entirely. If you want lower-level control or are building something beyond credential issuance, build on the API directly.

Want early access or have integration questions? Reach out via Andamio Pioneers.