A simple list-based mechanism for publishing and checking the status of a credential.

Comments regarding this document are welcome. Please file issues directly on GitHub, or send them to public-credentials@w3.org (subscribe, archives).

Introduction

A simple list-based mechanism for publishing and checking the status of a credential.

{
  "id": "http://dmv.example.gov/credentials/3732",
  "type": ["Credential", "ProofOfAgeCredential"],
  "issuer": "https://dmv.example.gov/issuers/14",
  "issued": "2010-01-01T19:73:24Z",
  "claim": {
    "id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
    "ageOver": 21
  },
  "credentialStatus": {
    "id": "https://dmv.example.gov/status/24,
    "type": "CredentialStatusList2017"
  },
  "proof": { ... }
}

Data Model

Include the data model for the list-based credential revocation

{
  "id": "https://dmv.example.gov/status/24,
  "description": "Status of example Department of Motor Vehicles credentials."
  "verifiableCredential": [{
    "claim": {
      "id": "http://dmv.example.gov/credentials/3732",
      "currentStatus": "Revoked",
      "statusReason": "Disciplinary action"
    },
    "issuer": "http://dmv.example.gov/",
    "issued": "2017-12-05T14:27:42Z",
    "proof": { ... }
  }, {
    "claim": {
      "id": "http://dmv.example.gov/credentials/2363",
      "currentStatus": "Suspended",
      "statusReason": "Investigation"
    },
    "issuer": "http://dmv.example.gov/",
    "issued": "2017-12-04T14:27:42Z",
    "proof": { ... }
  },
    // ... more status info here ...
  }],
  "proof": { ... }
}

Protocol

Include the protocol for the list-based credential revocation, which is basically HTTP GET.

GET /status/24 HTTP/1.1
Host: dmv.example.gov
Content-Type: application/ld+json
Content-Length: 1062
Accept: application/ld+json, application/json, text/plain, */*
Accept-Encoding: gzip, deflate
Link: <https://w3id.org/credentials/v1>;
  rel="http://www.w3.org/ns/json-ld#context";
  type="application/ld+json"

{
  "id": "https://dmv.example.gov/status/24,
  "description": "Status of example Department of Motor Vehicles credentials."
  "verifiableCredential": [{
    "claim": {
      "id": "http://dmv.example.gov/credentials/3732",
      "currentStatus": "Revoked",
      "statusReason": "Disciplinary action"
    },
    "issuer": "http://dmv.example.gov/",
    "issued": "2017-12-05T14:27:42Z",
    "proof": { ... }
  }, {
    "claim": {
      "id": "http://dmv.example.gov/credentials/2363",
      "currentStatus": "Suspended",
      "statusReason": "Investigation"
    },
    "issuer": "http://dmv.example.gov/",
    "issued": "2017-12-04T14:27:42Z",
    "proof": { ... }
  },
    // ... more status info here ...
  }],
  "proof": { ... }
}