API Reference
This page provides interactive API documentation for the SIROS ID platform services. Each API specification can be explored below, and the raw OpenAPI/Swagger files are available for download.
Go-Trust API
The Go-Trust API is a multi-framework trust decision engine providing AuthZEN-based trust evaluation. It supports ETSI TS 119612 trusted lists, OpenID Federation, and DID Web trust frameworks.
- Version: 2.0
- License: BSD-2-Clause
- Repository: sirosfoundation/go-trust
- Spec: Download OpenAPI spec
Expand Go-Trust API
Wallet Backend Admin API
Internal administration API for managing the wallet backend multi-tenant infrastructure. This API manages tenants, users, credential issuers, and verifiers.
- Version: 1.1.0
- License: Apache 2.0
- Repository: sirosfoundation/go-wallet-backend
- Spec: Download OpenAPI spec
Expand Wallet Backend Admin API
VC Platform APIs
The VC platform provides the core credential issuance and verification services for SIROS ID. It exposes several service-specific APIs:
API Gateway (Datastore)
The API Gateway (apigw) serves the OpenID4VCI/OAuth endpoints and the datastore REST API of the VC platform. The specification below covers the datastore operations only, not every apigw route. All paths in it already include the /api/v1 prefix.
- Version: 2.8
- Spec: Download Swagger spec
Expand API Gateway API
Registry (Token Status Lists)
The VC registry service is the Token Status List service: it serves GET /statuslists and GET /statuslists/{id}, plus an optional admin GUI under /admin. See Token Status Lists. The Swagger specification published for it, vc-registry-swagger.yaml, currently defines no paths, so no interactive documentation is shown here.
Issuer
The VC issuer service is a gRPC service (proto/v1-issuer.proto in the VC repository); over HTTP it exposes only /health and /swagger. The Swagger specification published for it, vc-issuer-swagger.yaml, currently defines no paths. See API Integration for the gRPC interface.