Hawkin Dynamics
Beta API · v1.13

Hawkin Dynamics
Force Platform API

Programmatic access to your athlete test data, force-time curves, metrics, and athlete management. Built for teams integrating HD data into performance intelligence pipelines.

Base URL
cloud.hawkindynamics.com
region-dependent
Auth Scheme
Bearer Token (JWT)
Protocol
HTTPS · REST · JSON
Important: This API is designed for server-to-server integration to sync data into your own database — not for direct client-app access. Large databases must use syncFrom/syncTo to paginate requests. Responses exceeding the memory limit will fail.

Getting Started

Follow these steps to make your first authenticated API call.

1

Generate a Refresh Token

Log into your Hawkin Dynamics account as an organization administrator. Navigate to Settings → Integrations and create a new API token. Only org admins can generate tokens.

2

Exchange for an Access Token

Use your refresh token to obtain a short-lived access token from /api/token. Access tokens expire after 1 hour.

3

Make API Requests

Include the access token in every request as a Bearer token in the Authorization header.

4

Implement Sync Strategy

Use syncFrom/syncTo for ongoing scheduled pulls. Use from/to for historical bulk exports by month.

Quick Example

Fetch an access token then pull recent test data.

# Step 1: Get Access Token TOKEN_RESPONSE=$(curl -s \ -H "Authorization: Bearer <YOUR_REFRESH_TOKEN>" \ "https://cloud.hawkindynamics.com/api/token") ACCESS_TOKEN=$(echo $TOKEN_RESPONSE | jq -r '.access_token') # Step 2: Get tests from the past 7 days SEVEN_DAYS_AGO=$(date -v-7d +%s) curl -H "Authorization: Bearer $ACCESS_TOKEN" \ "https://cloud.hawkindynamics.com/api/v1?syncFrom=$SEVEN_DAYS_AGO"

Regional Endpoints

Connect to the region matching your organization's data residency.

Region Base URL Notes
Americas https://cloud.hawkindynamics.com Default · US data residency
Europe https://eu.cloud.hawkindynamics.com EU data residency
Asia-Pacific https://apac.cloud.hawkindynamics.com APAC data residency

Data Sync Strategy

Two recommended patterns for keeping your database current.

// Pattern A: Scheduled incremental sync (every 5 min) async function incrementalSync(lastSyncTime) { const response = await fetch( `/api/v1?syncFrom=${lastSyncTime}&syncTo=${Date.now() / 1000}`, { headers: { Authorization: `Bearer ${accessToken}` } } ); const { data, lastSyncTime: newSyncTime } = await response.json(); // store newSyncTime for next run return { data, newSyncTime }; } // Pattern B: Historical bulk export by month async function bulkExport(startDate, endDate) { const months = getMonthRanges(startDate, endDate); const results = await Promise.all( months.map(({ from, to }) => fetch(`/api/v1?from=${from}&to=${to}`, headers) ) ); return results.flat(); }
Reference

Test Metrics

Complete reference for all metrics returned by the API, grouped by test type. The id shown for each metric is the property name you'll see in API responses — use these exact strings when accessing test data programmatically.

Loading metrics…
Version History

API Changelog

Changes, additions, and deprecations to the Hawkin Dynamics API.

Apr 2026
v1.13
Added Added

includeInactive filter & cursor-based pagination on Get Tests

Added includeInactive boolean parameter (default true) to the Get Tests endpoint, allowing filtering to only active tests. Added opt-in cursor-based pagination via paginate and cursor parameters — returns 1,000 tests per page with hasMore and nextCursor in the response.

Mar 2026
v1.12
Updated

Endpoint path updated to /api/v1

The primary data endpoint has been updated from its previous path to /api/v1. Removed deprecated configuration section from documentation. All integrations should update their base endpoint references.

Jan 2025
v1.11
Updated

Endpoint standardization

Updated endpoint reference to align with /api/v1 standard. Improved documentation consistency across all endpoint descriptions.

Jan 2023
v1.10-beta
Added Added

Bulk athlete operations & team scoping on tests

Added bulk create and bulk update endpoints for athletes (up to 500 per request). Introduced teamId and groupId query parameters on the tests endpoint supporting comma-separated lists of up to 10 IDs. Added testTypeId query parameter to filter test results by type.

Earlier
v1.0–v1.9
Added

Initial beta API release

Core endpoints for test retrieval, athlete management, force-time data, teams, groups, test types, metrics, and tags. Bearer token authentication via refresh/access token exchange.