# win.tomo-x.rogaining.listEvents

> Published by [tomo-x.win](https://lexicon.garden/identity/did:plc:qcwvyds5tixmcwkwrg3hxgxd)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:qcwvyds5tixmcwkwrg3hxgxd/win.tomo-x.rogaining.listEvents)
- [Documentation](https://lexicon.garden/lexicon/did:plc:qcwvyds5tixmcwkwrg3hxgxd/win.tomo-x.rogaining.listEvents/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:qcwvyds5tixmcwkwrg3hxgxd/win.tomo-x.rogaining.listEvents/examples)

## Definitions

### `win.tomo-x.rogaining.listEvents`

**Type**: `query`

List rogaining events, newest first.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `approver` | `string` (did) | No | Only events approved by this DID. |
| `status` | `string` | No | Filter by event period relative to now. |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `events` | `array` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "List rogaining events, newest first.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "events": {
              "items": {
                "ref": "win.tomo-x.rogaining.defs#eventView",
                "type": "ref"
              },
              "type": "array"
            }
          },
          "required": [
            "events"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "approver": {
            "description": "Only events approved by this DID.",
            "format": "did",
            "type": "string"
          },
          "status": {
            "description": "Filter by event period relative to now.",
            "knownValues": [
              "upcoming",
              "ongoing",
              "ended"
            ],
            "type": "string"
          }
        },
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "win.tomo-x.rogaining.listEvents",
  "lexicon": 1
}
```