Complete technical documentation for the race horse pedigree platform. Supports Hybrid Authentication (Firebase + Custom JWT).
http://localhost:3000/api/v1Authorization
header.
We support two authentication paths: Firebase SSO (Google/Email) and Custom JWT (Email/Password). Identity is unified across both systems.
Create a new unverified account. Triggers a verification email via Nodemailer.
Body
{
"username": "johndoe",
"email": "john@sample.com",
"password": "strongPassword123!"
}
Activates a custom account using the verification token sent via email.
Log in with email/password. Returns a Custom JWT. Fails if the email is not verified.
Body
{
"loginKey": "john@sample.com",
"password": "strongPassword123!"
}
Hybrid endpoint. Verifies either token and returns the user's role and database ID.
Public endpoint. Returns a paginated list of all horses.
Fetches a real horse pedigree for a specific number of generations.
Create a new horse record. Ownership is tied to the authenticated user's ID.
Body
{
"name": "Super Sprinter",
"sex": "Stallion",
"sireId": 497875,
"damId": 376952
}
Returns all available subscription plans.