ARIAAPI Reference

The public read-only API at api.aria.bar. No authentication required.

Base URL

https://api.aria.bar/v1

Endpoints

Resolve AID by DID

GET /v1/aids/{did}

Returns the current active AID for a given did:aria DID.

Response:

{
  "did": "did:aria:space.bar:procurement-agent-001",
  "aid": { ... },
  "resolvedAt": "2026-04-01T12:00:00Z"
}

Resolve credential instance by ID

GET /v1/credentials/{credentialId}

Returns the AID for a specific historical instance, identified by its UUIDv7 credential ID (active or revoked). This endpoint is what the W3C VC top-level id field of every AID dereferences to. Use it to walk the chain of issuances via credentialSubject.previousCredentialId.

Path parameter:

• credentialId — UUIDv7 (e.g. 01906b8f-7c8a-7d12-8e3f-2a91b4c8f019)

Response:

{
  "data": {
    "credentialId": "01906b8f-7c8a-7d12-8e3f-2a91b4c8f019",
    "previousCredentialId": "https://api.aria.bar/v1/credentials/01905f23-3a1b-7c95-9d6e-b8e72f5104a3",
    "did": "did:aria:space.bar:procurement-agent-001",
    "isActive": true,
    "validFrom": "2026-04-28T09:10:40Z",
    "validUntil": "2027-04-28T09:10:40Z",
    "revocation": null,
    "vcJsonLd": { /* the signed AID */ }
  }
}

For revoked instances, isActive: false and revocation: { reason, revokedAt }.

Verify AID

GET /v1/verify/{did}

Verifies the AID's signature, revocation status, and expiration. Returns a complete verification result.

Response:

{
  "did": "did:aria:space.bar:procurement-agent-001",
  "valid": true,
  "trustLevel": "L3",
  "status": "active",
  "expiresAt": "2027-04-01T00:00:00Z",
  "signatures": {
    "mlDsa65": "valid",
    "ed25519": "valid",
    "composite": "valid"
  },
  "revocationStatus": "not-revoked",
  "verifiedAt": "2026-04-01T12:00:00Z"
}

Check Revocation Status

GET /v1/status/{did}

Lightweight revocation check. Returns only status, not the full AID.

Lookup Organization

GET /v1/orgs/{domain}

Returns organization information for a registered domain.

Get Audit Trail

GET /v1/audit/{did}

Returns the append-only audit trail for a DID.

List Scopes

GET /v1/scopes

Returns the full normative ARIA scope registry.

Rate Limits

| Endpoint | Limit | Window | |----------|-------|--------| | All endpoints | 300 req | 1 minute per IP | | /v1/verify | 100 req | 1 minute per IP |

Rate limit headers are included in every response:

RateLimit-Limit: 300
RateLimit-Remaining: 297
RateLimit-Reset: 1712000060