---
title: "Fetch a list of signers provided by an FID"
method: GET
path: "/v1/onChainSignersByFid"
tags: ["OnChainEvents"]
---

# Fetch a list of signers provided by an FID

`GET /v1/onChainSignersByFid`

**Note:** one of two different response schemas is returned based on whether the caller provides the `signer` parameter. If included, a single `OnChainEventSigner` message is returned (or a `not_found` error). If omitted, a non-paginated list of `OnChainEventSigner` messages is returned instead.

## Query parameters

- `fid` integer, required
- `signer` string

## Response `200`

A successful response.

- 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
  - object
    - `events` OnChainEventSigner[], required
      - `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

## 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)