invalid_timezone

Timezone is not an IANA name

HTTP status

400

Error type

invalid_request

What it means#

We were given something like "+05:30" instead of "Asia/Kolkata".

What to do#

Send the IANA zone name:

"timezone": "Asia/Kolkata"    // ✅
"timezone": "+05:30"          // ❌ this error

This is not pedantry. A fixed offset cannot express a historical daylight-saving transition, and India observed DST as recently as 1945. For a birth inside such a window an offset silently shifts the chart by the length of the error — and an hour of error moves the ascendant about 15°, which is half a sign.

Never construct the zone from the user's current device offset either; it must be the offset in force at the moment of birth, which only the zone name can supply.

The error shape#

{
  "error": {
    "type": "invalid_request",
    "code": "invalid_timezone",
    "message": "\u2026",
    "doc_url": "https://docs.grahvani.in/errors/invalid_timezone",
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T"
  }
}

Full list: all error codes · error handling guide.