Entity reconciliation record linking local entities to external authorities
Record Key
tid
Timestamp-based ID
Properties
confidence
integer
Required
Match confidence score (scaled by 1000 for 0.0-1.0 range)
minimum: 0maximum: 1000createdAt
string
datetime
Required
An RFC 3339 formatted timestamp.
matchType
string
Optional
Type of semantic match (SKOS mapping)
Known values:
exact, close, broad, narrow, relatednotes
string
Optional
Notes about the reconciliation
maxLength: 1000 bytesschemaRevision
integer
Optional
Schema revision this record was created with. Absent means revision 1.
minimum: 1sourceUri
string
at-uri
Required
AT-URI of local entity being reconciled
status
string
Required
Reconciliation status
Known values:
proposed, verified, rejectedtargetId
string
Required
Identifier in the external system
targetSystem
string
Required
External authority system
Known values:
wikidata, lcsh, fast, ror, orcid, viaf, gnd, mesh, aat, gettyupdatedAt
string
datetime
Optional
An RFC 3339 formatted timestamp.
verifiedBy
string
did
Optional
DID of user who verified the match
View raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"sourceUri",
"targetSystem",
"targetId",
"confidence",
"status",
"createdAt"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 1000,
"description": "Notes about the reconciliation"
},
"status": {
"type": "string",
"description": "Reconciliation status",
"knownValues": [
"proposed",
"verified",
"rejected"
]
},
"targetId": {
"type": "string",
"description": "Identifier in the external system"
},
"createdAt": {
"type": "string",
"format": "datetime"
},
"matchType": {
"type": "string",
"description": "Type of semantic match (SKOS mapping)",
"knownValues": [
"exact",
"close",
"broad",
"narrow",
"related"
]
},
"sourceUri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of local entity being reconciled"
},
"updatedAt": {
"type": "string",
"format": "datetime"
},
"confidence": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"description": "Match confidence score (scaled by 1000 for 0.0-1.0 range)"
},
"verifiedBy": {
"type": "string",
"format": "did",
"description": "DID of user who verified the match"
},
"targetSystem": {
"type": "string",
"description": "External authority system",
"knownValues": [
"wikidata",
"lcsh",
"fast",
"ror",
"orcid",
"viaf",
"gnd",
"mesh",
"aat",
"getty"
]
},
"schemaRevision": {
"type": "integer",
"minimum": 1,
"description": "Schema revision this record was created with. Absent means revision 1."
}
}
},
"description": "Entity reconciliation record linking local entities to external authorities"
}