Developer API

JSON endpoints for trust signals, public profile summaries, and honor-note summaries—authenticated with API keys you control from your dashboard.

Create account Sign in

Base URL

All routes below are relative to:

https://bymyhonor.com/api

Authentication

Send your key in the Authorization header as Bearer bmh_… (full key shown once when you create it in the dashboard). Keys are scoped to sandbox or production and can be revoked at any time.

Endpoints

Method & path	Description
`GET /v1/ping`	Health check; returns environment echo.
`GET /v1/trust/{accountid}`	Honor score & validation status for a public account ID.
`GET /v1/profile/{accountid}`	Limited public profile fields.
`GET /v1/honornotes/{accountid}`	Recent closed honor notes for the holder (capped list).
`GET /v1/summary/{accountid}`	Aggregated honor-note counts and score.

Rate limits apply per key and IP. Response bodies are JSON; errors use conventional HTTP status codes with a message field where applicable.