---
title: "Fetch a list of on-chain events provided by an FID"
method: GET
path: "/v1/onChainEventsByFid"
tags: ["OnChainEvents"]
---

# Fetch a list of on-chain events provided by an FID

`GET /v1/onChainEventsByFid`

Fetch on-chain events provided by a user.

## Query parameters

- `fid` integer, required
- `event_type` 'EVENT_TYPE_SIGNER' | 'EVENT_TYPE_SIGNER_MIGRATED' | 'EVENT_TYPE_ID_REGISTER' | 'EVENT_TYPE_STORAGE_RENT', required

## Response `200`

A successful response.

- object
  - `events` OnChainEvent[], required
    - union
      - OnChainEventSigner
        - `type` string, required
        - `chainId` integer, required
        - `blockNumber` integer, required
        - `blockHash` string, required
        - `blockTimestamp` integer, required
        - `transactionHash` string, required
        - `logIndex` integer, required
        - `txIndex` integer, required
        - `fid` integer, required
        - `signerEventBody` SignerEventBody, required
          - `key` string, required
          - `keyType` integer, required
          - `eventType` 'SIGNER_EVENT_TYPE_ADD' | 'SIGNER_EVENT_TYPE_REMOVE' | 'SIGNER_EVENT_TYPE_ADMIN_RESET', required
          - `metadata` string, byte, required
          - `metadataType` integer, required
      - OnChainEventSignerMigrated
        - `type` string, required
        - `chainId` integer, required
        - `blockNumber` integer, required
        - `blockHash` string, required
        - `blockTimestamp` integer, required
        - `transactionHash` string, required
        - `logIndex` integer, required
        - `txIndex` integer, required
        - `fid` integer, required
        - `signerMigratedEventBody` SignerMigratedEventBody, required
          - `migratedAt` integer, required
      - OnChainEventIdRegister
        - `type` string, required
        - `chainId` integer, required
        - `blockNumber` integer, required
        - `blockHash` string, required
        - `blockTimestamp` integer, required
        - `transactionHash` string, required
        - `logIndex` integer, required
        - `txIndex` integer, required
        - `fid` integer, required
        - `idRegisterEventBody` IdRegisterEventBody, required
          - `to` string, required
          - `eventType` 'ID_REGISTER_EVENT_TYPE_REGISTER' | 'ID_REGISTER_EVENT_TYPE_TRANSFER' | 'ID_REGISTER_EVENT_TYPE_CHANGE_RECOVERY', required
          - `from` string, required
          - `recoveryAddress` string, required
      - OnChainEventStorageRent
        - `type` string, required
        - `chainId` integer, required
        - `blockNumber` integer, required
        - `blockHash` string, required
        - `blockTimestamp` integer, required
        - `transactionHash` string, required
        - `logIndex` integer, required
        - `txIndex` integer, required
        - `fid` integer, required
        - `storageRentEventBody` StorageRentEventBody, required
          - `payer` string, byte, required
          - `units` integer, required
          - `expiry` integer, required

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/neynar/apis/neynar-api.md) · [All operations](https://skmtc.net/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neynar/neynar-api/versions/dbb91bfb0d1a/schema)