Andamioscan API

Version: 1.0 Environment: preprod

Andamioscan is the indexer for Andamio Protocol on-chain data. It provides read-only access to indexed blockchain state including courses, students, modules, and transaction history.

Base URL: https://preprod.andamioscan.io/api

Andamioscan will be integrated into the unified Andamio API in a future release. The current endpoints are accessible directly at the base URL above.

API Categories

Courses

Query course data and enrolled students:

GET /v2/courses - List all courses
GET /v2/courses/{course_id} - Get specific course
GET /v2/courses/{course_id}/students - Get students in a course
GET /v2/courses/{course_id}/students/{alias} - Get specific student

Transactions

Query indexed transactions:

GET /v2/transactions - List transactions (filter by type)
GET /v2/transactions/count - Get transaction counts by type
GET /v2/transactions/{tx_hash} - Get transaction by hash

Transaction Detail Endpoints

Get decoded transaction data by type. Each endpoint links to the corresponding V2 protocol documentation:

Endpoint	Description	Related
`/v2/transactions/useraccesstoken/mint/{tx_hash}`	Access token mint	V2 Docs
`/v2/transactions/admincourse/create/{tx_hash}`	Course creation	V2 Docs
`/v2/transactions/admincourse/teachers_update/{tx_hash}`	Teacher update	V2 Docs
`/v2/transactions/studentcourse/assignment_commit/{tx_hash}`	Enrollment + Assignment commit	V2 Docs
`/v2/transactions/studentcourse/assignment_update/{tx_hash}`	Assignment update	V2 Docs
`/v2/transactions/studentcourse/credential_claim/{tx_hash}`	Credential claim	V2 Docs
`/v2/transactions/teachercourse/assignments_assess/{tx_hash}`	Assignment assessment	V2 Docs
`/v2/transactions/teachercourse/modules_manage/{tx_hash}`	Module management	V2 Docs

Users

Query user global state:

GET /v2/user/all - List all users
GET /v2/user/global-state/{alias} - Get user's global state with courses

Transaction Types

When filtering transactions via GET /v2/transactions?type=..., use these type values:

Type	Description	V2 Docs
`UserAccessTokenMint`	Protocol entry - mint access token	View →
`AdminCourseCreate`	Admin creates a course	View →
`AdminCourseTeachersUpdate`	Admin updates course teachers	View →
`StudentCourseAssignmentCommit`	Student enrolls and commits to assignment	View →
`StudentCourseAssignmentUpdate`	Student updates submission	View →
`StudentCourseCredentialClaim`	Student claims credential	View →
`TeacherCourseAssignmentsAssess`	Teacher assesses assignments	View →
`TeacherCourseModulesManage`	Teacher manages modules	View →

Swagger UI

Interactive API documentation is available at: https://preprod.andamioscan.io/api

V2 Transaction Documentation - How V2 transactions work on-chain
V2 Cost Estimation - Transaction costs and fee structures
What's New in V2 - Protocol changes and improvements