API Reference
API Reference
Complete AgeOnce API documentation
API Reference
REST API documentation for integrating AgeOnce into your application.
Base URL
https://app.ageonce.comAuthentication
AgeOnce uses OAuth 2.0 Authorization Code Flow. For API requests you need:
- Client ID — public identifier
- Client Secret — secret key (server-side only)
Never use Client Secret in frontend code!
Endpoints
OAuth Flow
Authorization and redirects
Token Exchange
POST /api/oauth/token
Token Validation
POST /api/oauth/validate
JWKS
GET /api/oauth/jwks
Response format
All responses are returned in JSON format:
{
"age_token": "...",
"token_type": "Bearer",
"expires_in": 600
}Error codes
| HTTP code | Description |
|---|---|
| 200 | Success |
| 400 | Invalid request parameters |
| 401 | Invalid credentials |
| 403 | Access denied |
| 404 | Resource not found |
| 500 | Internal server error |
SDK and libraries
We currently offer REST API with examples for popular languages: