# pub.chive.activity.getFeed

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

## Definitions

### `pub.chive.activity.getFeed`

**Type**: `query`

Get the authenticated user's activity feed with pagination

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `limit` | `integer` | No | Maximum number of results to return |
| `cursor` | `string` | No | Pagination cursor |
| `status` | `string` | No | Filter by activity status |
| `category` | `string` | No | Filter by activity category |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cursor` | `string` | No | Pagination cursor for next page |
| `hasMore` | `boolean` | Yes | Whether more results are available |
| `activities` | `array` | Yes |  |

#### Errors

- **AuthenticationRequired**

### `pub.chive.activity.getFeed#activityView`

**Type**: `object`

View of an activity log entry

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | Yes | Unique activity identifier (UUID) |
| `rkey` | `string` | Yes | Record key |
| `action` | `string` | Yes | Action type |
| `status` | `string` | Yes | Activity status |
| `actorDid` | `string` (did) | Yes | DID of user who initiated the action |
| `category` | `string` | Yes | Semantic activity category |
| `errorCode` | `string` | No | Error code if activity failed |
| `latencyMs` | `integer` | No | Latency from UI initiation to firehose confirmation (milliseconds) |
| `targetUri` | `string` (at-uri) | No | Target record URI |
| `collection` | `string` | Yes | NSID of the record collection |
| `confirmedAt` | `string` (datetime) | No | When firehose confirmed the action |
| `firehoseCid` | `string` | No | CID from firehose confirmation |
| `firehoseUri` | `string` (at-uri) | No | AT-URI from firehose confirmation |
| `initiatedAt` | `string` (datetime) | Yes | When user initiated the action |
| `targetTitle` | `string` | No | Target record title for display |
| `errorMessage` | `string` | No | Error message if activity failed |

## Raw Schema

```json
{
  "id": "pub.chive.activity.getFeed",
  "defs": {
    "main": {
      "type": "query",
      "errors": [
        {
          "name": "AuthenticationRequired"
        }
      ],
      "output": {
        "schema": {
          "type": "object",
          "required": [
            "activities",
            "hasMore"
          ],
          "properties": {
            "cursor": {
              "type": "string",
              "description": "Pagination cursor for next page"
            },
            "hasMore": {
              "type": "boolean",
              "description": "Whether more results are available"
            },
            "activities": {
              "type": "array",
              "items": {
                "ref": "#activityView",
                "type": "ref"
              }
            }
          }
        },
        "encoding": "application/json"
      },
      "parameters": {
        "type": "params",
        "properties": {
          "limit": {
            "type": "integer",
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "description": "Maximum number of results to return"
          },
          "cursor": {
            "type": "string",
            "description": "Pagination cursor"
          },
          "status": {
            "type": "string",
            "description": "Filter by activity status",
            "knownValues": [
              "pending",
              "confirmed",
              "failed",
              "timeout"
            ]
          },
          "category": {
            "type": "string",
            "description": "Filter by activity category",
            "knownValues": [
              "eprint_submit",
              "eprint_update",
              "eprint_delete",
              "review_create",
              "review_update",
              "review_delete",
              "endorsement_create",
              "endorsement_delete",
              "tag_create",
              "tag_delete",
              "profile_update",
              "proposal_create",
              "vote_create"
            ]
          }
        }
      },
      "description": "Get the authenticated user's activity feed with pagination"
    },
    "activityView": {
      "type": "object",
      "required": [
        "id",
        "actorDid",
        "collection",
        "rkey",
        "action",
        "category",
        "status",
        "initiatedAt"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique activity identifier (UUID)"
        },
        "rkey": {
          "type": "string",
          "description": "Record key"
        },
        "action": {
          "type": "string",
          "description": "Action type",
          "knownValues": [
            "create",
            "update",
            "delete"
          ]
        },
        "status": {
          "type": "string",
          "description": "Activity status",
          "knownValues": [
            "pending",
            "confirmed",
            "failed",
            "timeout"
          ]
        },
        "actorDid": {
          "type": "string",
          "format": "did",
          "description": "DID of user who initiated the action"
        },
        "category": {
          "type": "string",
          "description": "Semantic activity category",
          "knownValues": [
            "eprint_submit",
            "eprint_update",
            "eprint_delete",
            "review_create",
            "review_update",
            "review_delete",
            "endorsement_create",
            "endorsement_delete",
            "tag_create",
            "tag_delete",
            "profile_update",
            "proposal_create",
            "vote_create"
          ]
        },
        "errorCode": {
          "type": "string",
          "description": "Error code if activity failed"
        },
        "latencyMs": {
          "type": "integer",
          "description": "Latency from UI initiation to firehose confirmation (milliseconds)"
        },
        "targetUri": {
          "type": "string",
          "format": "at-uri",
          "description": "Target record URI"
        },
        "collection": {
          "type": "string",
          "description": "NSID of the record collection"
        },
        "confirmedAt": {
          "type": "string",
          "format": "datetime",
          "description": "When firehose confirmed the action"
        },
        "firehoseCid": {
          "type": "string",
          "description": "CID from firehose confirmation"
        },
        "firehoseUri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI from firehose confirmation"
        },
        "initiatedAt": {
          "type": "string",
          "format": "datetime",
          "description": "When user initiated the action"
        },
        "targetTitle": {
          "type": "string",
          "description": "Target record title for display"
        },
        "errorMessage": {
          "type": "string",
          "description": "Error message if activity failed"
        }
      },
      "description": "View of an activity log entry"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1
}
```
