Skip to main content

Getting Started

This guide walks you through your first authenticated call to the Destiny API.

1. Confirm your host​

Every endpoint lives under the /api/v1 prefix on the ACM Destiny API host:

https://www.acmdestiny.net/api/v1

So a call to Find User Basic Details is https://www.acmdestiny.net/api/v1/users/basic.

2. Check connectivity​

The ping endpoint requires no authentication and confirms the server is reachable:

curl https://www.acmdestiny.net/api/v1/tests/ping \
  -H "Content-Type: application/json"
{
  "data": { "message": "pong" }
}

3. Log in to get a token​

curl -X POST https://www.acmdestiny.net/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"your-username","password":"your-password"}'

The token is returned in the Authorization response header. Copy it for the next step. (See Authentication for the full token lifecycle, including refresh.)

4. Make your first authenticated request​

curl https://www.acmdestiny.net/api/v1/units \
  -H "Authorization: bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

5. Explore the reference​

Every endpoint — with its parameters, request body, response schema and code samples in curl, Python, Node, PHP, C# and Java — is documented in the API Reference.

Next steps