Skip to content
OpenSourceSoftware.ai

GitHub stars

80,718
—Awaiting first sync

Awaiting first sync

No measured star history yet

What is Hoppscotch?

Hoppscotch gives a team one place to try out APIs, keep the requests worth reusing and check that they still work. It runs in a browser tab, as a desktop app for macOS, Windows and Linux, or from the command line. The Community Edition can be hosted on your own servers.

Hoppscotch is an open-source API development tool for sending and testing requests in the browser, a desktop app or a command-line client. It covers REST, GraphQL and realtime protocols, and lets teams share collections and environments in workspaces.

Core capabilities

  • Test REST, GraphQL, WebSocket, Server-Sent Events, Socket.IO and MQTT APIs from one app.
  • Share collections and environments in workspaces with owner, editor and viewer roles.
  • Run saved collections as automated tests from a terminal with the hopp test command.

Test REST, GraphQL and realtime APIs

Requests support the standard HTTP methods, authorization such as Basic, Bearer token and OAuth 2.0, and JSON, form data and other body types. Pre-request scripts and post-request tests are written in JavaScript. The same app also connects to GraphQL schemas, WebSocket, Server-Sent Events, Socket.IO and MQTT. Each request can also be turned into code for more than ten languages.

  • REST
  • GraphQL
  • WebSocket
  • MQTT

Collections, workspaces and the command line

Collections, folders and environments live in a personal workspace or in shared workspaces with owner, editor and viewer roles. Shared workspaces currently cover REST requests only; GraphQL and realtime stay in the personal workspace. The Hoppscotch CLI, still labelled alpha, runs a collection with its tests, can read an environment file and writes JUnit reports. It needs Node.js 22 or newer.

  • Workspaces
  • Environments
  • CLI
  • Testing

Self-host the Community Edition

The Community Edition is MIT licensed and needs a PostgreSQL database. Run it with the all-in-one Docker image or separate frontend, backend and admin images, then apply the database migrations. The admin dashboard is where you set up and manage users and teams. The Enterprise Edition is open-core and adds SAML and OpenID Connect sign-in, audit logs and priority support under separate terms.

  • Self-hosted
  • Docker
  • PostgreSQL
  • MIT

Where it fits

Use cases

  1. 01

    Check an API before developers build on it

    Enter the URL, pick the method, add headers, authorization and a body, then send the request and read the response. Generate code snippets or import a cURL command to hand the working call to a developer.

  2. 02

    Share a request library with the team

    Group requests into collections and folders, store base URLs and keys as environment variables, and put them in a shared workspace. Give colleagues the editor role to change them or viewer to read only.

  3. 03

    Run API checks from a build pipeline

    Add test scripts to the requests in a collection, export it and run hopp test with an environment file. The command exits with an error if any check fails, and can write a JUnit XML report.