ARIAAPI Reference

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

Base URL

https://api.aria.bar/v1

Endpoints

Resolve AID

GET /v1/aids/{did}

Returns the full AID document for a given did:aria DID.

Response:

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

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