REST API overview

Base: https://api.reqistry.dev · JSON only · Reads public, writes bearer-authenticated.

Quick contract

Auth: Authorization: Bearer <accessToken> from /v1/auth/anonymous or /v1/auth/login-email. Reads except /v1/stack, notifications, and writes need no token. Rate limit 100 req/min free; 429 on exceed. Errors: { error, message }.

Public endpoints (v1 recommended)

GET /v1/categoriesList categories with apiCount

GET /v1/categories/:id/apis?page=&limit=APIs in category, paginated

GET /v1/apis/:slugFull profile (health/metadata/verification) · ETag+304

GET /v1/apis/:id/alternatives?limit=2|3Similar APIs (same category → apiType)

GET /v1/trust-scores/:idTrust score + factor breakdown

GET /v1/apis/compare?ids=a,b[,c,d]Compare 2–4 APIs

GET /v1/change-feed?limit=Pricing/docs/OpenAPI/health/trust events

GET /v1/use-case-collectionsCurated packs for common builds

GET /v1/recently-added?limit=Latest published APIs

GET /v1/recommend?limit=Personalized (if bookmarked) else random

POST /v1/apisCommunity submission (pending review)

GET /v1/auth/meProfile + stats (auth)

Legacy (Flutter-compat, deprecated — use v1)

GET /search?q=&category=&auth=&pricing=&cors=&https=&alive=&sortBy=&page=&limit=Search/filter/sort/paginate (https string, isAlive bool, api/cors pricing strings)

GET /recommend?type=best|similar|usecaseLegacy recommend

GET /categories, /trendy-categoriesLegacy category lists

POST /submitLegacy submit

OpenAPI

GET /openapi.jsonFull spec (45 paths) — same as openapi.mobile.json, served live

GET /openapi.mobile.jsonAlias — mobile client canonical copy

bash

curl https://api.reqistry.dev/openapi.json | jq .paths | head
# mobile app: fetch /openapi.mobile.json and generate Dart models from components/schemas/*

Examples

bash

curl https://api.reqistry.dev/v1/categories
curl https://api.reqistry.dev/v1/apis/open-meteo
curl "https://api.reqistry.dev/v1/apis/compare?ids=open-meteo,openweather"

Spec source: openapi.mobile.json (committed) + live at GET /openapi.json. Handlers in apps/api/src/routes/v1/*. Docs IA: apps/docs/src/app/api/*.