Geotrackable API

Health check

This route is anonymous and is the fastest way to confirm that the production API host is reachable.

curl "https://Geotrackable.com/api/system/status"

{
  "status": "online",
  "utcNow": "2026-06-20T12:00:00Z",
  "androidBetaPageUrl": "https://Geotrackable.com/en-US/Account/Beta"
}

Register

Create a local account with an email, password, and public profile user name before requesting a bearer token. User names may contain lowercase letters, numbers, and underscores only.

curl -X POST "https://Geotrackable.com/api/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tester@example.com",
    "userName": "trail_tester",
    "password": "StrongP@ssw0rd!"
  }'

Bearer login

Use local account credentials with cookies disabled when a script, app, or API client needs a bearer token.

curl -X POST "https://Geotrackable.com/api/auth/login?useCookies=false&useSessionCookies=false" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tester@example.com",
    "password": "StrongP@ssw0rd!"
  }'

{
  "tokenType": "Bearer",
  "accessToken": "eyJhbGciOi..."
}

Current account and profile

There is no GET /api/account profile endpoint. Use the identity manage-info endpoint for signed-in account metadata, and use the website profile pages for public profile display.

GET /api/account is not a published read route.

GET /api/auth/manage/info returns signed-in identity details.

DELETE /api/account permanently deletes the current account.

curl "https://Geotrackable.com/api/auth/manage/info" \
  -H "Authorization: Bearer <access token>"

Public browse and lookup

curl "https://Geotrackable.com/api/trackables/public?contentLanguage=en-US"

curl -X POST "https://Geotrackable.com/api/trackables/lookup" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "GT7F3K9"
  }'

Create a trackable

curl -X POST "https://Geotrackable.com/api/trackables" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Scout trail coin",
    "description": "Move this coin along family-friendly trails.",
    "visibility": "AlwaysVisibleToEveryone",
    "activateImmediately": true,
    "secretCode": ""
  }'

Active secret access

After a browser enters a valid secret code or scan payload, the active-session routes show what that browser can currently reopen.

curl "https://Geotrackable.com/api/trackables/active"

curl -X POST "https://Geotrackable.com/api/trackables/active/13a2c0b1-582f-4a7b-92aa-16922f7bdb63/message" \
  -H "Content-Type: application/json" \
  -d '{
    "statusMessage": "Live hunt in progress"
  }'

Images

List reads can be anonymous when the parent page is public-safe. Upload and delete routes require bearer auth.

curl "https://Geotrackable.com/api/images/trackables/13a2c0b1-582f-4a7b-92aa-16922f7bdb63"

curl -X POST "https://Geotrackable.com/api/images/trackables/13a2c0b1-582f-4a7b-92aa-16922f7bdb63" \
  -H "Authorization: Bearer <access token>" \
  -F "files=@trail-coin.jpg"

External link verification

Verify an external link before storing it on a location, team, trackable, or trackable group.

curl -X POST "https://Geotrackable.com/api/external-links/verify" \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/trail-guide"
  }'

Content and error reports

Use reports for public-page content concerns and errors for client-side diagnostics that support may need to review.

curl -X POST "https://Geotrackable.com/api/compliance/reports" \
  -H "Content-Type: application/json" \
  -d '{
    "pageType": "Trackable",
    "contentType": "Trackable",
    "pageTitle": "Scout trail coin",
    "pageUrl": "https://Geotrackable.com/trackable/GT7F3K9",
    "pageReference": "GT7F3K9",
    "contentLabel": "Trackable page",
    "contentReference": "13a2c0b1-582f-4a7b-92aa-16922f7bdb63",
    "contentPreview": "Move this coin along family-friendly trails.",
    "reportTitle": "Outdated public link",
    "reportExplanation": "The linked trail guide now points somewhere unexpected."
  }'