# org.rcape.docket

> Published by [ape.rcape.org](https://lexicon.garden/identity/did:plc:rju7piux7nfkb76ofze72uwn)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:rju7piux7nfkb76ofze72uwn/org.rcape.docket)
- [Documentation](https://lexicon.garden/lexicon/did:plc:rju7piux7nfkb76ofze72uwn/org.rcape.docket/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:rju7piux7nfkb76ofze72uwn/org.rcape.docket/examples)

## Definitions

### `org.rcape.docket`

**Type**: `record`

A court case/docket. The repo identity IS the case; this self-keyed record carries case-level metadata (analogous to an actor profile).

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `court` | `string` | Yes | Court identifier, e.g. CourtListener court id 'mdd'. |
| `source` | `ref` → `#source` | Yes |  |
| `caseName` | `string` | Yes |  |
| `courtName` | `string` | No | Human-readable court, e.g. 'U.S. District Court, District of Maryland'. |
| `createdAt` | `string` (datetime) | No |  |
| `dateFiled` | `string` (datetime) | No |  |
| `docketNumber` | `string` | Yes | e.g. '8:25-cv-00951'. |
| `natureOfSuit` | `string` | No |  |
| `assignedJudge` | `string` | No |  |
| `dateTerminated` | `string` (datetime) | No |  |

### `org.rcape.docket#source`

**Type**: `object`

Provenance pointer to the upstream record this was mirrored from.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `url` | `string` (uri) | No | Canonical upstream URL. |
| `provider` | `string` | Yes | Upstream source, e.g. 'courtlistener'. |
| `retrievedAt` | `string` (datetime) | Yes | When RC Ape observed this content (witness timestamp). |
| `providerDocketId` | `string` | No | Upstream's stable id for this docket. |

## Raw Schema

```json
{
  "id": "org.rcape.docket",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "court",
          "docketNumber",
          "caseName",
          "source"
        ],
        "properties": {
          "court": {
            "type": "string",
            "description": "Court identifier, e.g. CourtListener court id 'mdd'."
          },
          "source": {
            "ref": "#source",
            "type": "ref"
          },
          "caseName": {
            "type": "string"
          },
          "courtName": {
            "type": "string",
            "description": "Human-readable court, e.g. 'U.S. District Court, District of Maryland'."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "dateFiled": {
            "type": "string",
            "format": "datetime"
          },
          "docketNumber": {
            "type": "string",
            "description": "e.g. '8:25-cv-00951'."
          },
          "natureOfSuit": {
            "type": "string"
          },
          "assignedJudge": {
            "type": "string"
          },
          "dateTerminated": {
            "type": "string",
            "format": "datetime"
          }
        }
      },
      "description": "A court case/docket. The repo identity IS the case; this self-keyed record carries case-level metadata (analogous to an actor profile)."
    },
    "source": {
      "type": "object",
      "required": [
        "provider",
        "retrievedAt"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Canonical upstream URL."
        },
        "provider": {
          "type": "string",
          "description": "Upstream source, e.g. 'courtlistener'."
        },
        "retrievedAt": {
          "type": "string",
          "format": "datetime",
          "description": "When RC Ape observed this content (witness timestamp)."
        },
        "providerDocketId": {
          "type": "string",
          "description": "Upstream's stable id for this docket."
        }
      },
      "description": "Provenance pointer to the upstream record this was mirrored from."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```
