A profile stores a person's birth date, time, and location. All calculation endpoints require a profileId from a previously created profile.

List profiles

GET /v1/profiles

Returns all profiles linked to your account.

Response

{
  "success": true,
  "data": [
    {
      "id": "683abc123def456",
      "name": "Arun Sharma",
      "date": "1990-06-15",
      "time": "06:30",
      "location": "Kathmandu, Nepal",
      "timezone": "Asia/Kathmandu",
      "latitude": 27.7172,
      "longitude": 85.3240,
      "gender": "male"
    }
  ]
}

---

Create a profile

POST /v1/profiles

Request body

Field	Type	Required	Description
name	string	Yes	Person's name
gender	"male" | "female"	Yes	Gender (affects chart interpretation)
date	string	Yes	Birth date in YYYY-MM-DD format
time	string	Yes	Birth time in HH:MM (24h) format
timezone	string	Yes	IANA timezone e.g. "Asia/Kathmandu"
location	string	Yes	Human-readable location name
latitude	number	Yes	Birth latitude (decimal degrees)
longitude	number	Yes	Birth longitude (decimal degrees)
notes	string	No	Optional notes (max 500 chars)

Example

curl -X POST https://api.askvedicguru.com/api/v1/profiles \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "name": "Arun Sharma",
    "gender": "male",
    "date": "1990-06-15",
    "time": "06:30",
    "timezone": "Asia/Kathmandu",
    "location": "Kathmandu, Nepal",
    "latitude": 27.7172,
    "longitude": 85.3240
  }'

Response

{
  "success": true,
  "data": {
    "id": "683abc123def456",
    "name": "Arun Sharma",
    "date": "1990-06-15",
    "time": "06:30",
    "location": "Kathmandu, Nepal",
    "timezone": "Asia/Kathmandu",
    "latitude": 27.7172,
    "longitude": 85.3240,
    "gender": "male"
  }
}