Harbor

Harbor Leaderboards API

Operations for retrieving leaderboard rankings of community members by points or other engagement metrics.

Documentation GitHub OpenAPI

Operations 1

GET /communities/{communityId}/leaderboard Harbor Get community leaderboard #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/harbor-leaderboards-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Harbor Challenges Leaderboards API
  description: The Harbor API enables programmatic access to the Harbor community platform, allowing brands to manage their superfan community, rewards programs, and engagement features. Harbor is a no-code tool that lets brands build owned community platforms where superfans can engage and earn rewards. The API provides endpoints for managing members, challenges, rewards, redemptions, leaderboards, and community events. Authentication uses bearer tokens obtained via OAuth 2.0 client credentials.
  version: v1
  contact:
    name: Harbor Support
    url: https://www.harbor.gg/
  termsOfService: https://www.harbor.gg/terms
servers:
- url: https://api.harbor.gg/v1
  description: Harbor API Production Server
security:
- bearerAuth: []
tags:
- name: Leaderboards
  description: Operations for retrieving leaderboard rankings of community members by points or other engagement metrics.
paths:
  /communities/{communityId}/leaderboard:
    get:
      operationId: getLeaderboard
      summary: Harbor Get community leaderboard
      description: Returns the ranked leaderboard of community members sorted by total points earned. Supports optional time-window filtering for weekly or monthly leaderboards.
      tags:
      - Leaderboards
      parameters:
      - $ref: '#/components/parameters/communityIdParam'
      - $ref: '#/components/parameters/limitParam'
      - name: period
        in: query
        description: Time period for leaderboard calculation.
        schema:
          type: string
          enum:
          - all_time
          - monthly
          - weekly
          default: all_time
      responses:
        '200':
          description: Leaderboard rankings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Leaderboard'
        '401':
          description: Unauthorized.
        '404':
          description: Community not found.
components:
  parameters:
    communityIdParam:
      name: communityId
      in: path
      required: true
      description: The unique identifier of the Harbor community.
      schema:
        type: string
    limitParam:
      name: limit
      in: query
      description: Number of results per page.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
  schemas:
    Tier:
      type: object
      description: Loyalty tier a member has achieved.
      properties:
        id:
          type: string
          description: Tier identifier.
        name:
          type: string
          description: Tier display name (e.g., Bronze, Silver, Gold).
        pointsRequired:
          type: integer
          description: Minimum lifetime points required to reach this tier.
        benefits:
          type: array
          description: List of benefits associated with this tier.
          items:
            type: string
    LeaderboardEntry:
      type: object
      description: A single entry in the community leaderboard.
      properties:
        rank:
          type: integer
          description: Member's current rank position on the leaderboard.
          minimum: 1
        memberId:
          type: string
          description: Member identifier.
        displayName:
          type: string
          description: Member's display name.
        points:
          type: integer
          description: Points total used for ranking.
          minimum: 0
        tier:
          $ref: '#/components/schemas/Tier'
    Leaderboard:
      type: object
      description: Community leaderboard with ranked member entries.
      properties:
        communityId:
          type: string
          description: Community identifier.
        period:
          type: string
          description: Time period this leaderboard covers.
          enum:
          - all_time
          - monthly
          - weekly
        entries:
          type: array
          description: Ranked list of member entries.
          items:
            $ref: '#/components/schemas/LeaderboardEntry'
        generatedAt:
          type: string
          format: date-time
          description: Timestamp when the leaderboard was last calculated.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token obtained via OAuth 2.0 client credentials flow. Contact Harbor to obtain API credentials.
externalDocs:
  description: Harbor API Documentation
  url: https://api.harbor.gg/