Moon Banking Logo

Bank Votes

A bank vote represents a user's rating of a bank, either positive or negative.

The bankVote model

The bank vote model contains voting information for banks, including the vote direction. When fetching votes, the related bank and/or country data may optionally be included in the response.

Properties

    Name
    id
    Type
    string
    Description

    The vote's auto-generated unique identifier.

    Name
    isUp
    Type
    boolean
    Description

    Whether this is an upvote (true) or downvote (false).

    Name
    category
    Type
    enum
    Description

    The category in which the vote was cast.

    Possible values: CRYPTO_FRIENDLY, CUSTOMER_SERVICE, FEES_PRICING, DIGITAL_EXPERIENCE, SECURITY_TRUST, ACCOUNT_FEATURES, BRANCH_ATM_ACCESS, INTERNATIONAL_BANKING, BUSINESS_BANKING, PROCESSING_SPEED, TRANSPARENCY, INNOVATION, INVESTMENT_SERVICES, LENDING

    Name
    bankId
    Type
    string
    Description

    The ID of the bank for which the vote was cast.

    Name
    createdAt
    Type
    string
    Description

    The date and time the vote was created in Moon Banking.

    Name
    updatedAt
    Type
    string
    Description

    The date and time the vote was last updated in Moon Banking.

    Name
    bank
    Type
    object
    Description

    The bank for which the vote was cast.

    Name
    country
    Type
    object
    Description

    The country in which the bank is located.

GET/bank-votes

GET /bank-votes

This endpoint allows you to retrieve a paginated list of bank votes. You can filter by bank ID, category, country, vote type (upvote or downvote), and other parameters.

Optional parameters

    Name
    limit
    Type
    integer
    Constraints
    min1•max100
    Default
    default10
    Description

    Number of items to return.

    Name
    starting_after
    Type
    string
    Description

    Cursor for forward pagination. Use the id of the last item from the previous page to get the next page.

    Name
    ending_before
    Type
    string
    Description

    Cursor for backward pagination. Use the id of the first item from the current page to get the previous page.

    Name
    bankId
    Type
    string
    Description

    The bank's auto-generated unique identifier.

    Name
    categories
    Type
    string
    Description

    An optional comma-separated list of fields to include in the response. Possible values: CRYPTO_FRIENDLY, CUSTOMER_SERVICE, FEES_PRICING, DIGITAL_EXPERIENCE, SECURITY_TRUST, ACCOUNT_FEATURES, BRANCH_ATM_ACCESS, INTERNATIONAL_BANKING, BUSINESS_BANKING, PROCESSING_SPEED, TRANSPARENCY, INNOVATION, INVESTMENT_SERVICES, LENDING

    Name
    isUp
    Type
    boolean
    Description

    Whether to filter for upvotes (true) or downvotes (false).

    Name
    countryCode
    Type
    string
    Constraints
    min2•max2
    Description

    The country's ISO 3166-1 code (2 characters).

    Name
    sortBy
    Type
    enum
    Default
    default"createdAt"
    Description

    Field to sort by.

    Possible values: createdAt

    Name
    sortOrder
    Type
    enum
    Default
    default"desc"
    Description

    Sort order. Either ascending or descending.

    Possible values: asc, desc

    Name
    include
    Type
    string
    Description

    An optional comma-separated list of fields to include in the response. Possible values: bank, country

Request

GET
/bank-votes
curl -G https://api.moonbanking.com/v1/bank-votes \
  -H "Authorization: Bearer {your_api_key}" \
  -H "Moon-Banking-Version: 2025-07-11" \
  --data-urlencode "limit=20" \
  --data-urlencode "starting_after=8HsY5nBc7jAqM4u" \
  --data-urlencode "ending_before=6jkxE4N8gHXgDPK" \
  --data-urlencode "bankId=6jkxE4N8gHXgDPK" \
  --data-urlencode "categories=CRYPTO_FRIENDLY%2CCUSTOMER_SERVICE%2CFEES_PRICING%2CDIGITAL_EXPERIENCE%2CSECURITY_TRUST%2CACCOUNT_FEATURES%2CBRANCH_ATM_ACCESS%2CINTERNATIONAL_BANKING%2CBUSINESS_BANKING%2CPROCESSING_SPEED%2CTRANSPARENCY%2CINNOVATION%2CINVESTMENT_SERVICES%2CLENDING" \
  --data-urlencode "isUp=true" \
  --data-urlencode "countryCode=US" \
  --data-urlencode "sortBy=createdAt" \
  --data-urlencode "sortOrder=desc" \
  --data-urlencode "include=bank%2Ccountry"

Response

{
  "success": true,
  "data": [
    {
      "id": "1",
      "isUp": true,
      "category": "CRYPTO_FRIENDLY",
      "bankId": "6jkxE4N8gHXgDPK",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "bank": {
        "id": "6jkxE4N8gHXgDPK",
        "name": "Fidelity",
        "countryId": "454hfjsjuusbf"
      },
      "country": {
        "id": "454hfjsjuusbf",
        "name": "United States",
        "code": "US",
        "emoji": "🇺🇸"
      }
    },
    ...
  ],
  "pagination": {
    "hasMore": true,
    "limit": 20,
    "nextCursor": "8HsY5nBc7jAqM4u",
    "previousCursor": "6jkxE4N8gHXgDPK",
    "meta": {
      "total": 42
    }
  },
  "message": "Sample message",
  "timestamp": "2026-02-12T21:20:01.641Z",
  "version": "2025-07-11"
}

Was this page helpful?