# pub.chive.eprint.citation

> 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.eprint.citation)
- [Documentation](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.eprint.citation/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.eprint.citation/examples)

## Definitions

### `pub.chive.eprint.citation`

**Type**: `record`

User-curated citation linking an eprint to a cited work

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `context` | `string` | No | Contextual note explaining the citation |
| `citedWork` | `ref` → `#citedWork` | Yes |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `eprintUri` | `string` (at-uri) | Yes | AT-URI of the eprint that cites this work |
| `citationType` | `string` | No | Semantic type of the citation relationship |
| `schemaRevision` | `integer` | No | Schema revision this record was created with. Absent means revision 1. |

### `pub.chive.eprint.citation#citedWork`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `doi` | `string` | No | DOI of the cited work |
| `url` | `string` (uri) | No | URL of the cited work |
| `year` | `integer` | No | Publication year of the cited work |
| `title` | `string` | Yes | Title of the cited work |
| `venue` | `string` | No | Publication venue (journal or conference) |
| `arxivId` | `string` | No | arXiv identifier of the cited work |
| `authors` | `array` | No | Author names of the cited work |
| `chiveUri` | `string` (at-uri) | No | AT-URI of the cited work if it exists in Chive |

## Raw Schema

```json
{
  "id": "pub.chive.eprint.citation",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "eprintUri",
          "citedWork",
          "createdAt"
        ],
        "properties": {
          "context": {
            "type": "string",
            "maxLength": 1000,
            "description": "Contextual note explaining the citation"
          },
          "citedWork": {
            "ref": "#citedWork",
            "type": "ref"
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "eprintUri": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI of the eprint that cites this work"
          },
          "citationType": {
            "type": "string",
            "description": "Semantic type of the citation relationship",
            "knownValues": [
              "cites",
              "extends",
              "refutes",
              "reviews",
              "uses-data",
              "uses-method"
            ]
          },
          "schemaRevision": {
            "type": "integer",
            "minimum": 1,
            "description": "Schema revision this record was created with. Absent means revision 1."
          }
        }
      },
      "description": "User-curated citation linking an eprint to a cited work"
    },
    "citedWork": {
      "type": "object",
      "required": [
        "title"
      ],
      "properties": {
        "doi": {
          "type": "string",
          "maxLength": 200,
          "description": "DOI of the cited work"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "maxLength": 1000,
          "description": "URL of the cited work"
        },
        "year": {
          "type": "integer",
          "description": "Publication year of the cited work"
        },
        "title": {
          "type": "string",
          "maxLength": 1000,
          "description": "Title of the cited work"
        },
        "venue": {
          "type": "string",
          "maxLength": 500,
          "description": "Publication venue (journal or conference)"
        },
        "arxivId": {
          "type": "string",
          "maxLength": 50,
          "description": "arXiv identifier of the cited work"
        },
        "authors": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 200
          },
          "maxLength": 50,
          "description": "Author names of the cited work"
        },
        "chiveUri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the cited work if it exists in Chive"
        }
      }
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1
}
```