TaxCredential
{
"@context": [
"https://www.w3.org/2018/credentials/v1"
],
"id": "urn:uuid:4e7f3c21-5d8b-4f2a-9b11-1c2d3e4f5a67",
"type": [
"VerifiableCredential",
"TaxCredential"
],
"issuer": "did:gov:US:irs",
"issuanceDate": "2025-04-15T14:00:00Z",
"expirationDate": "2026-04-14T23:59:59Z",
"evidence": [
{
"type": "TaxAssessmentRecord",
"assessmentReference": "IRS-2024-5087321",
"assessedAt": "2025-04-05",
"source": "Internal Revenue Service Masterfile"
}
],
"credentialSubject": {
"id": "did:wallet:us-7890abcd",
"person": {
"givenName": "John",
"familyName": "Doe",
"dateOfBirth": "1988-06-22",
"tin": "US-98-7654321",
"taxResidency": {
"countryCode": "US"
},
"address": {
"street": "742 Evergreen Terrace",
"city": "Springfield",
"postalCode": "62704",
"countryCode": "US"
}
},
"assessmentSummary": {
"taxYear": 2024,
"filingStatus": "single",
"incomeStabilityYears": 4,
"employmentStatus": "employee",
"employerCount": 1,
"incomeBreakdown": {
"employmentIncome": {
"amount": 87500,
"currency": "USD"
},
"selfEmploymentIncome": {
"amount": 4500,
"currency": "USD"
},
"capitalIncome": {
"amount": 2500,
"currency": "USD"
}
},
"grossIncomeTotal": {
"amount": 94500,
"currency": "USD"
},
"deductionsTotal": {
"amount": 12500,
"currency": "USD"
},
"taxableIncome": {
"amount": 82000,
"currency": "USD"
},
"taxDueTotal": {
"amount": 15200,
"currency": "USD"
},
"withholdingPaid": {
"amount": 15000,
"currency": "USD"
},
"balanceOrRefund": {
"amount": 200,
"currency": "USD",
"direction": "owed"
},
"socialContributionsPaid": {
"amount": 3100,
"currency": "USD"
}
},
"clearance": {
"status": "inGoodStanding",
"asOf": "2025-04-05"
},
"derivedForLending": {
"annualNetIncomeEstimate": {
"amount": 67800,
"currency": "USD"
},
"monthlyNetIncomeEstimate": {
"amount": 5650,
"currency": "USD"
},
"incomeVerificationConfidence": "taxAuthorityVerified"
}
}
}
Manifest
{
"claims": {
"Taxpayer ID": "$.credentialSubject.person.tin",
"Given Name": "$.credentialSubject.person.givenName",
"Family Name": "$.credentialSubject.person.familyName",
"Date of Birth": "$.credentialSubject.person.dateOfBirth",
"Tax Residency Country": "$.credentialSubject.person.taxResidency.countryCode",
"Currency": "$.credentialSubject.assessmentSummary.grossIncomeTotal.currency",
"Street Address": "$.credentialSubject.person.address.street",
"City": "$.credentialSubject.person.address.city",
"Postal Code": "$.credentialSubject.person.address.postalCode",
"Country": "$.credentialSubject.person.address.countryCode",
"Tax Year": "$.credentialSubject.assessmentSummary.taxYear",
"Filing Status": "$.credentialSubject.assessmentSummary.filingStatus",
"Income Stability Years": "$.credentialSubject.assessmentSummary.incomeStabilityYears",
"Employment Status": "$.credentialSubject.assessmentSummary.employmentStatus",
"Employer Count": "$.credentialSubject.assessmentSummary.employerCount",
"Employment Income Amount": "$.credentialSubject.assessmentSummary.incomeBreakdown.employmentIncome.amount",
"Self Employment Income Amount": "$.credentialSubject.assessmentSummary.incomeBreakdown.selfEmploymentIncome.amount",
"Capital Income Amount": "$.credentialSubject.assessmentSummary.incomeBreakdown.capitalIncome.amount",
"Gross Income Amount": "$.credentialSubject.assessmentSummary.grossIncomeTotal.amount",
"Deductions Amount": "$.credentialSubject.assessmentSummary.deductionsTotal.amount",
"Taxable Income Amount": "$.credentialSubject.assessmentSummary.taxableIncome.amount",
"Tax Due Amount": "$.credentialSubject.assessmentSummary.taxDueTotal.amount",
"Withholding Paid Amount": "$.credentialSubject.assessmentSummary.withholdingPaid.amount",
"Balance or Refund Amount": "$.credentialSubject.assessmentSummary.balanceOrRefund.amount",
"Social Contributions Amount": "$.credentialSubject.assessmentSummary.socialContributionsPaid.amount",
"Balance or Refund Direction": "$.credentialSubject.assessmentSummary.balanceOrRefund.direction",
"Clearance Status": "$.credentialSubject.clearance.status",
"Clearance As Of": "$.credentialSubject.clearance.asOf",
"Annual Net Income Amount": "$.credentialSubject.derivedForLending.annualNetIncomeEstimate.amount",
"Monthly Net Income Amount": "$.credentialSubject.derivedForLending.monthlyNetIncomeEstimate.amount",
"Income Verification Confidence": "$.credentialSubject.derivedForLending.incomeVerificationConfidence"
}
}
Mapping example
{
"id": "<uuid>",
"issuer": "<issuerDid>",
"credentialSubject": {
"id": "<subjectDid>"
},
"issuanceDate": "<timestamp>",
"expirationDate": "<timestamp-in:365d>",
"evidence": [
{
"assessmentReference": "<assessmentReference>",
"assessedAt": "<date>",
"source": "<source>"
}
]
}