Developer API v2.0

Gravity Developer API

Build safety into your application. REST API, WebSockets, and Webhooks — with SDKs for Python, Node.js, React Native, and Flutter.

Quick Start Swagger UI

Quick Start

Authenticate and make your first API call in under 5 minutes.

STEP 1 — Authenticate

bash

curl -X POST https://api.gravity.trackalways.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "your_password"}'

RESPONSE

json

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 3600,
  "user": {
    "id": 1,
    "name": "Arjun Sharma",
    "email": "user@example.com"
  }
}

STEP 2 — Use the token to update location

bash

curl -X POST https://api.gravity.trackalways.com/location/update \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lat": 12.9716,
    "lng": 77.5946,
    "accuracy": 5.0,
    "speed": 0,
    "place_name": "Bengaluru, Karnataka"
  }'

API Reference

Base URL: https://api.gravity.trackalways.com

Authentication

POST/auth/register

POST/auth/login

POST/auth/otp/send

Send OTP to phone number

POST/auth/otp/verify

Verify OTP and authenticate

Rate Limits

Limits are per API key, per rolling hour window.

Tier

API Requests

Location Updates

SOS Triggers

Free

100/hour

30/hour

Unlimited

Family

1,000/hour

120/hour

Unlimited

Family+

10,000/hour

360/hour

Unlimited

Enterprise

Custom

Unlimited

SDKs & Libraries

Official client libraries to get started in minutes.

🐍Python

terminal

pip install gravity-sdk

⬢Node.js

terminal

npm install @trackalways/gravity

⚛React Native

terminal

npm install @trackalways/gravity-rn

🎯Flutter

terminal

flutter pub add gravity_sdk

Developer Support

Questions about the API? Our developer team responds within 24 hours on business days.

Email Developer Support Interactive Docs