# gg.infinitetavern.tavern.getAdventurerChronicles

> Published by [infinitetavern.gg](https://lexicon.garden/identity/did:plc:vxwgn77hp5ikvbiggm5es3rv)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:vxwgn77hp5ikvbiggm5es3rv/gg.infinitetavern.tavern.getAdventurerChronicles)
- [Documentation](https://lexicon.garden/lexicon/did:plc:vxwgn77hp5ikvbiggm5es3rv/gg.infinitetavern.tavern.getAdventurerChronicles/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:vxwgn77hp5ikvbiggm5es3rv/gg.infinitetavern.tavern.getAdventurerChronicles/examples)

## Definitions

### `gg.infinitetavern.tavern.getAdventurerChronicles`

**Type**: `query`

Consult the tavern's grand ledger to retrieve an adventurer's indexed battle chronicles, ordered newest first.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` (did) | Yes | The adventurer's DID. |
| `limit` | `integer` | No |  |
| `offset` | `integer` | No |  |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cursor` | `string` | No | Offset-based pagination cursor (next offset as string). |
| `results` | `array` | Yes |  |

### `gg.infinitetavern.tavern.getAdventurerChronicles#matchResultView`

**Type**: `object`

An indexed chronicle entry — one adventurer's record from a single tavern battle.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | Yes |  |
| `did` | `string` (did) | Yes |  |
| `uri` | `string` (at-uri) | Yes |  |
| `heroKey` | `string` | Yes |  |
| `lobbyId` | `string` | Yes |  |
| `heroName` | `string` | Yes |  |
| `mmrAfter` | `number` | Yes |  |
| `playedAt` | `string` (datetime) | Yes |  |
| `mmrBefore` | `number` | Yes |  |
| `mmrChange` | `number` | Yes |  |
| `opponents` | `array` | Yes |  |
| `placement` | `integer` | Yes |  |
| `seasonNumber` | `integer` | Yes |  |
| `roundSurvived` | `integer` | Yes |  |

## Raw Schema

```json
{
  "id": "gg.infinitetavern.tavern.getAdventurerChronicles",
  "defs": {
    "main": {
      "type": "query",
      "output": {
        "schema": {
          "type": "object",
          "required": [
            "results"
          ],
          "properties": {
            "cursor": {
              "type": "string",
              "description": "Offset-based pagination cursor (next offset as string)."
            },
            "results": {
              "type": "array",
              "items": {
                "ref": "#matchResultView",
                "type": "ref"
              }
            }
          }
        },
        "encoding": "application/json"
      },
      "parameters": {
        "type": "params",
        "required": [
          "did"
        ],
        "properties": {
          "did": {
            "type": "string",
            "format": "did",
            "description": "The adventurer's DID."
          },
          "limit": {
            "type": "integer",
            "default": 20,
            "maximum": 100,
            "minimum": 1
          },
          "offset": {
            "type": "integer",
            "default": 0,
            "minimum": 0
          }
        }
      },
      "description": "Consult the tavern's grand ledger to retrieve an adventurer's indexed battle chronicles, ordered newest first."
    },
    "matchResultView": {
      "type": "object",
      "required": [
        "uri",
        "cid",
        "did",
        "lobbyId",
        "seasonNumber",
        "placement",
        "heroKey",
        "heroName",
        "roundSurvived",
        "mmrBefore",
        "mmrAfter",
        "mmrChange",
        "playedAt",
        "opponents"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid"
        },
        "did": {
          "type": "string",
          "format": "did"
        },
        "uri": {
          "type": "string",
          "format": "at-uri"
        },
        "heroKey": {
          "type": "string"
        },
        "lobbyId": {
          "type": "string"
        },
        "heroName": {
          "type": "string"
        },
        "mmrAfter": {
          "type": "number"
        },
        "playedAt": {
          "type": "string",
          "format": "datetime"
        },
        "mmrBefore": {
          "type": "number"
        },
        "mmrChange": {
          "type": "number"
        },
        "opponents": {
          "type": "array",
          "items": {
            "ref": "gg.infinitetavern.chronicle.entry#opponent",
            "type": "ref"
          }
        },
        "placement": {
          "type": "integer",
          "maximum": 8,
          "minimum": 1
        },
        "seasonNumber": {
          "type": "integer"
        },
        "roundSurvived": {
          "type": "integer",
          "minimum": 0
        }
      },
      "description": "An indexed chronicle entry — one adventurer's record from a single tavern battle."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```
