Skip to content
8033
Lovat

Getting Started with the Lovat API

Use the Lovat API to look up teams and tournaments from a script or integration. The examples below use the production API at https://api.lovat.app.

Make a read-only request to the public status endpoint. It returns Server running when the API is reachable.

Terminal window
curl --fail-with-body https://api.lovat.app/status

Send your credential in the Authorization header as a bearer token. Use an lvt- API key for scripts that support key authentication. The API reference lists the authentication, parameters, and permissions for each operation.

For help getting your first credential, contact the Lovat maintainers. The API reference accepts an existing access token or key. If you already have an Auth0 access token for the Lovat API and your account is on a verified team, open the reference, select Authorize, and enter the token in bearerAuth. Then use Create a new API key under Manager - API Keys and give the key a name that identifies the integration. Save the returned apiKey in your integration’s secret store. The list operation returns metadata, so copy the key when you create it. Revoke it in the reference if it is exposed.

Set LOVAT_API_KEY in your shell from your secret store, then run this request. It searches by team-number prefix and limits the response to five teams.

Terminal window
curl --silent --show-error --fail-with-body \
--header "Authorization: Bearer ${LOVAT_API_KEY:?Set LOVAT_API_KEY}" \
--header 'X-Lovat-Error-Format: json-v1' \
'https://api.lovat.app/v1/manager/teams?filter=8033&take=5'

On success, the response has a teams array and a count field. If the search has no matches, the array is empty.

X-Lovat-Error-Format: json-v1 requests structured errors. Use the HTTP status and code for decisions and message for readable feedback.

StatusWhat to check
400Check the endpoint’s parameters and any field names listed in invalidFields.
401Check the bearer header and whether the credential is still valid.
403Check the account’s permissions and whether the operation requires an Auth0 access token.
429Wait for Retry-After or retryAfterSeconds when provided. Space API-key requests by at least three seconds.

For other endpoints and their response schemas, see the interactive API reference or the OpenAPI JSON specification.