# pub.chive.graph.reconciliation

> Published by [chive.pub](https://lexicon.garden/identity/did:plc:7natp5xae72bddaqlkef2t4e)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.reconciliation)
- [Documentation](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.reconciliation/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.reconciliation/examples)

## Definitions

### `pub.chive.graph.reconciliation`

**Type**: `record`

Entity reconciliation record linking local entities to external authorities

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `notes` | `string` | No | Notes about the reconciliation |
| `status` | `string` | Yes | Reconciliation status |
| `targetId` | `string` | Yes | Identifier in the external system |
| `createdAt` | `string` (datetime) | Yes |  |
| `matchType` | `string` | No | Type of semantic match (SKOS mapping) |
| `sourceUri` | `string` (at-uri) | Yes | AT-URI of local entity being reconciled |
| `updatedAt` | `string` (datetime) | No |  |
| `confidence` | `integer` | Yes | Match confidence score (scaled by 1000 for 0.0-1.0 range) |
| `verifiedBy` | `string` (did) | No | DID of user who verified the match |
| `targetSystem` | `string` | Yes | External authority system |
| `schemaRevision` | `integer` | No | Schema revision this record was created with. Absent means revision 1. |

## Raw Schema

```json
{
  "id": "pub.chive.graph.reconciliation",
  "defs": {
    "main": {
      "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"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1
}
```