MOBILE-ID · TRUSTED LTANS

Evidence API

Retrieve evidence and exact revisions to inspect structure, history and data binding.

openapi.yaml openapi.json asyncapi.yaml postman-target.json

LOCAL SIMULATION · Target contracts · No network requests

GET/v1/archives/{archiveId}/evidence

TARGET CONTRACT · API 3.0.0-draft

Property	Value
Technical owner	Evidence Service
Application scope	evidence:read
HTTP	200
Call processing	Authentication/authorization → HTTP handling; not a resource-state enum.
Event	Audit or internal event

Poll the existing generation job; do not create a duplicate archive.

cURL

curl --fail-with-body --request GET \
  "${BASE_URL%/}/v1/archives/${ARCHIVE_ID}/evidence" \
  --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "X-Correlation-ID: ${CORRELATION_ID}"

Target response

{
  "archiveId": "arc-test-001",
  "version": 1,
  "syntax": "ASN1_ERS",
  "mediaType": "application/octet-stream",
  "downloadReference": "/v1/downloads/evidence-test-001",
  "digest": {
    "algorithm": "SHA-256",
    "value": "0000000000000000000000000000000000000000000000000000000000000000"
  },
  "policyHistory": [
    "policy-test-v1"
  ]
}

JSON Schema

{
  "type": "object",
  "properties": {
    "archiveId": {
      "type": "string"
    },
    "version": {
      "type": "integer",
      "minimum": 1
    },
    "syntax": {
      "type": "string",
      "enum": [
        "ASN1_ERS",
        "XMLERS"
      ]
    },
    "mediaType": {
      "type": "string"
    },
    "downloadReference": {
      "type": "string",
      "format": "uri-reference"
    },
    "digest": {
      "$ref": "#/components/schemas/Digest"
    },
    "policyHistory": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "archiveId",
    "version",
    "syntax",
    "downloadReference"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "archiveId": "arc-test-001",
      "version": 1,
      "syntax": "ASN1_ERS",
      "mediaType": "application/octet-stream",
      "downloadReference": "/v1/downloads/evidence-test-001",
      "digest": {
        "algorithm": "SHA-256",
        "value": "0000000000000000000000000000000000000000000000000000000000000000"
      },
      "policyHistory": [
        "policy-test-v1"
      ]
    }
  ]
}

application/problem+json

{
  "type": "https://example.invalid/problems/evidence-not-ready",
  "title": "Evidence Not Ready",
  "code": "EVIDENCE_NOT_READY",
  "detail": "The evidence version is not ready.",
  "correlationId": "corr-test-001",
  "requestId": "req-test-001",
  "retryable": false,
  "service": "Evidence Service",
  "timestamp": "2026-10-15T05:00:01Z",
  "errors": [],
  "status": 409,
  "instance": "urn:ltans:request:req-test-001"
}

GET/v1/archives/{archiveId}/evidence/{evidenceVersion}