PeerTalkButton preview
API reference
v2.0.0The complete API documentation — endpoints, parameters, token format and security model — lives on the developer portal.
Open the full API docsBase URL
https://id.peertalk.chat
Endpoints at a glance
| Method | Endpoint | Description |
|---|---|---|
| POST | /auth/register | Register a public key |
| POST | /auth/challenge | Get a one-time challenge to sign |
| POST | /auth/login | Log in → returns access + refresh token |
| POST | /auth/refresh | Refresh the access token |
| POST | /auth/logout | Log out the current session |
| POST | /auth/logout-all | Log out of all devices |
| POST | /api/verify | Verify a token (public endpoint) |
| GET | /api/userinfo | User info (OIDC) |
| GET | /api/status | Service health check |
| GET | /.well-known/openid-configuration | OIDC discovery |
POST /api/verify
The main endpoint for your backend to verify a token:
// Request
POST https://id.peertalk.chat/api/verify
{ "access_token": "eyJ..." }
// Response
{
"valid": true,
"sub": "uuid",
"accountId": "uuid",
"peertalkid_premium": false,
"scope": "openid profile",
"expires_in": 3597
}
Run requests against the live PeerTalkID API from your browser.
GET/api/status
Check whether the PeerTalkID service is running.
POST/api/verify
GET/.well-known/openid-configuration
OIDC discovery endpoint.