VC type
Employment Card

TASKS LIST

  • Add introduction
  • Create use cases
  • Document schema
  • Create references to standards and protocols

Employment Card (EmploymentCardCredential) type.

The EmploymentCardCredential is a type of verifiable credential that certifies an individual's current or past affiliation with an organization as an employee. This credential is designed to be a trusted and verifiable digital document that confirms a person’s employment status, job role, and other relevant details at a specific company.

Employment card credentials are widely used across corporate environments to verify an employee's position, department, and tenure within the organization. The credential provides essential information, such as the employee’s role, department, and the duration of their employment, offering a secure and verifiable way to assert their employment status.

To ensure the ongoing validity of the credential, a credentialStatus object is included. This object allows for real-time verification of whether the credential has been revoked or is still valid. The credentialStatus type, CredentialStatusList2017, provides an endpoint that can be queried to check the status of the credential. Additionally, an updateService is included to facilitate the updating of employment details, ensuring that any changes in the employee's role or status are accurately reflected in the credential.

Examples

Employment Card Credential Example

{
  "@context": [
    "https://www.w3.org/2018/credentials/v1",
    "https://schema.org/"
  ],
  "type": [
    "VerifiableCredential",
    "EmploymentCard"
  ],
  "issuer": {
    "id": "did:example:google123456"
  },
  "issuanceDate": "2024-08-08T00:00:00Z",
  "validFrom": "2024-08-08T00:00:00Z",
  "credentialSubject": {
    "id": "did:example:johnsmith789012",
    "type": "Person",
    "givenName": "John",
    "familyName": "Smith",
    "memberOf": {
      "@type": "Organization",
      "name": "Google",
      "logo": "ipfs://QmGoogleLogoHashExample",
      "department": {
        "@type": "Organization",
        "name": "Engineering"
      },
      "employeeID": "G12345678",
      "role": {
        "@type": "EmployeeRole",
        "jobTitle": "Senior Software Engineer",
        "startDate": "2020-01-15",
        "endDate": "Present"
      }
    },
    "email": "john.smith@google.com"
  },
  "credentialStatus": {
    "id": "https://agent.humancloud.network/status",
    "type": "CredentialStatusList2017"
  },
  "updateService": {
    "id": "https://agent.humancloud.network/update",
    "type": "CredentialUpdateService2020"
  },
  "credentialSchema": {
    "id": "https://schema.humancloud.network/v1/employment-card-credential-schema.json",
    "type": "JsonSchemaValidator2018"
  },
  "proof": {
    "type": "JwtProof2020",
    "jws": "eyJhbGciOiJFZERTQSIsIm...signature"
  }
}