> ## Documentation Index > Fetch the complete documentation index at: https://docs.neynar.com/llms.txt > Use this file to discover all available pages before exploring further. # List signers > Fetches a list of signers for a custody address ### Related tutorial: [Fetch signers](/docs/fetch-signers-1) ## Node.js SDK 🔗 **SDK Method:** [fetchSigners](/nodejs-sdk/signer-apis/fetchSigners) Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience. ## OpenAPI ````yaml get /v2/farcaster/signer/list/ openapi: 3.0.4 info: contact: email: team@neynar.com name: Neynar url: https://neynar.com/ description: >- The Neynar API allows you to interact with the Farcaster protocol among other things. See the [Neynar docs](https://docs.neynar.com/reference) for more details. title: Neynar API version: 3.173.0 servers: - url: https://api.neynar.com security: - ApiKeyAuth: [] tags: - description: Operations related to user externalDocs: description: More info about user url: https://docs.neynar.com/reference/user-operations name: User - description: Operations related to signer externalDocs: description: More info about signer url: https://docs.neynar.com/reference/signer-operations name: Signer - description: Operations related to cast externalDocs: description: More info about cast url: https://docs.neynar.com/reference/cast-operations name: Cast - description: Operations related to feed externalDocs: description: More info about feed url: https://docs.neynar.com/reference/feed-operations name: Feed - description: Operations related to reaction externalDocs: description: More info about reaction url: https://docs.neynar.com/reference/reaction-operations name: Reaction - description: Operations related to notifications externalDocs: description: More info about notifications url: https://docs.neynar.com/reference/notifications-operations name: Notifications - description: Operations related to channels externalDocs: description: More info about channels url: https://docs.neynar.com/reference/channel-operations name: Channel - description: Operations related to follows externalDocs: description: More info about follows url: https://docs.neynar.com/reference/follows-operations name: Follows - description: Operations related to storage externalDocs: description: More info about storage url: https://docs.neynar.com/reference/storage-operations name: Storage - description: Operations related to mini apps name: Frame - description: Operations for building AI agents name: Agents - description: Operations related to fname name: fname - description: Operations related to a webhook name: Webhook - description: >- Securely communicate and perform actions on behalf of users across different apps externalDocs: description: More info about farcaster actions url: https://docs.neynar.com/docs/farcaster-actions-spec name: Action - description: Operations related to a subscriptions name: Subscribers - description: Operations related to a mute name: Mute - description: Operations related to a block name: Block - description: Operations related to a ban name: Ban - description: Operations related to onchain data name: Onchain - description: Operations related to login name: Login - description: Operations related to retrieving metrics name: Metrics - description: Operations related to mini app host notifications externalDocs: description: More info about mini app host notifications url: https://docs.neynar.com/docs/app-host-notifications name: App Host paths: /v2/farcaster/signer/list/: get: tags: - Signer summary: List signers description: Fetches a list of signers for a custody address operationId: fetch-signers parameters: - description: >- A Sign-In with Ethereum (SIWE) message that the user's Ethereum wallet signs. This message includes details such as the domain, address, statement, URI, nonce, and other relevant information following the EIP-4361 standard. It should be structured and URL-encoded. in: query name: message required: true schema: example: >- example.com%20wants%20you%20to%20sign%20in%20with%20your%20Ethereum%20account%3A%5Cn0x23A...F232%5Cn%5CnSign%20in%20to%20continue.%5Cn%5CnURI%3A%20example.com%5CnVersion%3A%201%5CnChain%20ID%3A%201%5CnNonce%3A%20xyz123%5CnIssued%20At%3A%202021-09-01T14%3A52%3A07Z type: string - description: >- The digital signature produced by signing the provided SIWE message with the user's Ethereum private key. This signature is used to verify the authenticity of the message and the identity of the signer. in: query name: signature required: true schema: example: 0x25f8...1cf type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/SignerListResponse' description: Success '400': content: application/json: schema: $ref: '#/components/schemas/ErrorRes' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorRes' description: Unauthorized '500': content: application/json: schema: $ref: '#/components/schemas/ErrorRes' description: Server Error externalDocs: url: https://docs.neynar.com/reference/fetch-signers components: schemas: SignerListResponse: properties: signers: items: $ref: '#/components/schemas/Signer' type: array required: - signers title: SignerListResponse type: object ErrorRes: description: Details for the error response properties: code: type: string message: type: string property: type: string status: format: int32 type: integer required: - message title: ErrorRes type: object Signer: properties: fid: $ref: '#/components/schemas/Fid' object: enum: - signer type: string permissions: items: $ref: '#/components/schemas/SharedSignerPermission' type: array public_key: $ref: '#/components/schemas/Ed25519PublicKey' signer_approval_url: type: string signer_uuid: $ref: '#/components/schemas/SignerUUID' status: enum: - generated - pending_approval - approved - revoked type: string required: - signer_uuid - public_key - status title: Signer type: object Fid: description: The unique identifier of a farcaster user or app (unsigned integer) example: 3 format: int32 minimum: 0 title: Fid type: integer SharedSignerPermission: enum: - WRITE_ALL - READ_ONLY - NONE - PUBLISH_CAST - DELETE_CAST - PUBLISH_REACTION - DELETE_REACTION - UPDATE_PROFILE - FOLLOW_USER - UNFOLLOW_USER - FOLLOW_CHANNEL - UNFOLLOW_CHANNEL - ADD_VERIFICATION - REMOVE_VERIFICATION - WRITE_FRAME_ACTION title: SharedSignerPermission type: string Ed25519PublicKey: description: Ed25519 public key example: '0x3daa8f99c5f760688a3c9f95716ed93dee5ed5d7722d776b7c4deac957755f22' pattern: ^0x[a-fA-F0-9]{64}$ title: Ed25519PublicKey type: string SignerUUID: description: >- UUID of the signer. `signer_uuid` is paired with API key, can't use a `uuid` made with a different API key. example: 19d0c5fd-9b33-4a48-a0e2-bc7b0555baec title: SignerUUID type: string securitySchemes: ApiKeyAuth: description: API key to authorize requests in: header name: x-api-key type: apiKey x-default: NEYNAR_API_DOCS ````