This document is also available in these non-normative formats: Turtle and JSON-LD
Copyright © 2025 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
This document describes the Bitstring Status List Vocabulary, i.e., the RDFS [RDF-SCHEMA] vocabulary used by the Bitstring Status List v1.0 [VC-BITSTRING-STATUS-LIST].
Alternate versions of the vocabulary definition exist in Turtle and JSON-LD.
This vocabulary has been defined by the W3C Verifiable Credentials Working Group and provides the official RDFS vocabulary for Bitstring Status Lists. Comments regarding this document are welcome. Please file issues directly on GitHub, or send them to public-vc-comments@w3.org ( subscribe, archives).
In general, the terms — i.e., the properties and classes — used in
the VCDM are formally specified in Recommendation Track documents published by
the W3C Verifiable Credentials Working
Group. In each case of such external definition, the term's description in
this document contains a link to the relevant specification. Additionally, the
rdfs:definedBy property in the RDFS representation(s) refers to the formal
specification.
In some cases, a local explanation is necessary to complement, or to replace,
the definition found in an external specification. For instance, this is so when
the term is needed to provide a consistent structure to the RDFS vocabulary,
such as when the term defines a common supertype for class instances that are
used as objects of specific properties. For such cases,
the extra definition is included in the current
document (and the rdfs:comment property is used to include them in the RDFS
representations).
xsd
datatypes). The terms prefixed by cred: or sec: are not defined in this vocabulary;
they have only been added to the diagram for the sake of clarity.This specification makes use of the following namespaces:
cshttps://www.w3.org/ns/credentials/status#credhttps://w3.org/2018/credentials#sechttps://w3id.org/security#dchttp://purl.org/dc/terms/owlhttp://www.w3.org/2002/07/owl#rdfhttp://www.w3.org/1999/02/22-rdf-syntax-ns#rdfshttp://www.w3.org/2000/01/rdf-schema#xsdhttp://www.w3.org/2001/XMLSchema#vshttp://www.w3.org/2003/06/sw-vocab-status/ns#schemahttp://schema.org/jsonldhttp://www.w3.org/ns/json-ld#The following @context files make use of the terms defined in this specification:
The following are property definitions in the cs namespace.
The purpose of the status list
See the formal definition of the term.
xsd:stringBitstringStatusListBitstringStatusListEntry@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2The position of the entry in the status list
See the formal definition of the term.
xsd:stringBitstringStatusListEntry@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2The location of the status list credential
See the formal definition of the term.
The property's value should be a URL, i.e., not a literal.
BitstringStatusListCredentialBitstringStatusListEntry@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2The encoded status list bitstring
See the formal definition of the term.
sec:multibaseBitstringStatusList@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Time to live in milliseconds
See the formal definition of the term.
xsd:stringBitstringStatusList@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Bitstring entry size in bits
See the formal definition of the term.
xsd:positiveIntegerBitstringStatusList@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Status message
See the formal definition of the term.
The property's value should be a URL, i.e., not a literal.
BitstringStatusMessageBitstringStatusList@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Hexadecimal value of a status message
See the formal definition of the term.
xsd:stringBitstringStatusMessage@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Human-readable message of a status value
See the formal definition of the term.
xsd:stringBitstringStatusMessage@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Reference documentation for status messages
See the formal definition of the term.
The property's value should be a URL, i.e., not a literal.
BitstringStatusList@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2The following are class definitions in the cs namespace.
Bitstring status list class
See the formal definition of the term.
encodedList, ttl, statusSize, statusMessage, statusReferencestatusPurpose@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Bitstring status list entry class
See the formal definition of the term.
cred:CredentialStatusstatusListIndex, statusListCredentialstatusPurpose@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Bitstring status list credential class
See the formal definition of the term.
cred:VerifiableCredentialstatusListCredential@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2Bitstring status message class
See the formal definition of the term.
statusMessagestatus, message@contexts:https://www.w3.org/ns/credentials/status/v1, https://www.w3.org/ns/credentials/v2xsd datatypes). The terms prefixed by cred: or
sec: are not defined in this vocabulary; they have only been added to the diagram for the sake of clarity.The diagram uses boxes, ellipses, and connecting lines with different "styles" (border color, end marker, line type) to differentiate their semantic meaning: "Property", "Class", and "Datatype" are identified by the shape of the graph node (e.g., an ellipse signifies a "Class"); "Superclass", "Domain Of", or "Range" relationships are identified by the style of the connecting line. These style names are used in the explanation text that follows, below.
The diagram is roughly divided into three sections — left, middle, and right. To make this description easier to understand, these sections will be respectively referred to as the "Classes", "Properties", and "Values" sections. Shapes in the three sections are connected by lines of different styles.
The section contains three ellipses, labeled as "cred:CredentialStatus", "BitstringStatusListEntry", and "BitstringStatusList". It also contains a box, styled as "Property" and labeled as "cred:credentialStatus".
The "cred:CredentialStatus" ellipse, is connected to the ellipse, labeled as "cred:CredentialStatus", with a line styled "Range". The ellipse labeled as "BitstringStatusListEntry" is connected to the ellipse, labeled as "cred:CredentialStatus", with a line styled as "Superclass".
The ellipses labeled as "BitstringStatusListEntry" and "BitstringStatusList" are also connected to a number of boxes, all styled as "Property", with lines styled as "Domain Of"; see the "Properties" section below for further details.
The section contains a number of boxes, each styles as "Property". The labels of these boxes are "statusListIndex", "statusListCredential", "statusPurpose", "statusMessage", "ttl", "statusReference", "statusSize", and "encodedList". There is also a small, unlabeled circle, which serves as an intersection point for connector lines.
The ellipse labeled as "BitstringStatusListEntry", described in the previous section, is connected to the "statusListIndex", and "statusListCredential" boxes with lines styled as "Domain Of". The ellipse labeled as "BitstringStatusList", also described in the previous section, is connected to the "statusMessage", "ttl", "statusReference", "statusSize", and "encodedList" boxes, also with lines styled as "Domain Of".
Both the ellipses labeled as "BitstringStatusListEntry" and "BitstringStatusList" are connected to the intersection point with a line styled as "Domain Of", and the intersection point is connected to the box labeled as "statusPurpose with a line styled as "Domain Of".
The section contains and ellipse, labeled as "BitstringStatusListCredential", which is connected to another ellipse, labeled as "cred:VerifiableCredential", with a line styled as "Superclass". The box labeled as "statusListCredential", described in the previous section, is connected to the ellipse, labeled as "BitstringStatusListCredential", with a line styled as "Range".
Another ellipse, labeled as "BistringStatusMessage", is connected to two boxes with lines styled as "Domain Of". The boxes are styled as "Property" and are labeled with "status" and "message". The box labeled as "statusMessage", described in the previous section, is connected to the ellipse, labeled as "BistringStatusMessage", with a line styled as "Range".
The box labeled as "statusSize", described in the previous section, is connected to a box, styled as "Datatype", and labeled as "xsd:positiveInteger", with a line styled as "Range".
The box labeled as "encodedList", described in the previous section, is connected to a box, styled as "Datatype", and labeled as "sec:multibase", with a line styled as "Range".