NOTE: If you are using this API, please sign up to the developer mailing list here so you can be informed of any updates or scheduled maintenance to the API.

Endpoints - Hijri / Gregorian Dates

Please note that given the nature of the computation, Hijri - Gregorian date conversions can always be off by one day.
All endoints are available over https and httpss.

1. Convert a Gregorian date to a Hijri date - http://api.aladhan.com/v1/gToH/:date
2. Request a Hijri Calendar for a Gregorian month - http://api.aladhan.com/v1/gToHCalendar/:month/:year
3. Convert a Hijri date to a Gregorian date - http://api.aladhan.com/v1/hToG/:date
4. Request a Gregoran Calendar for a Hijri month - http://api.aladhan.com/v1/hToGCalendar/:month/:year

1. Convert a Gregorian date to a Hijri date - http://api.aladhan.com/v1/gToH/:date

• Description:

  Convert a Gregorian date to a Hijri date

• Method: GET
• Parameters:
  • "date" (string) -

    A gregorian date formatted as DD-MM-YYYY

  • "adjustment" (number) -

    Number of days to adjust hijri date(s). Example: 1 or 2 or -1 or -2

• Endpoint URL: http://api.aladhan.com/v1/gToH/:date
• Example Request: http://api.aladhan.com/v1/gToH/07-12-2014
• Example Response:

  HTTP/1.1 200 OK
  {
      {
          code: 200,
          status: "OK",
          data: {
              hijri: {
                  date: "14-02-1436",
                  format: "DD-MM-YYYY",
                  day: "14",
                  month: {
                      number: 2,
                      en: "Ṣafar",
                      ar: "صَفَر"
                  },
                  year: "1436",
                  designation: {
                      abbreviated: "AH",
                      expanded: "Anno Hegirae"
                  }
              },
              gregorian: {
                  date: "07-12-2014",
                  format: "DD-MM-YYYY",
                  day: "07",
                  month: {
                      number: 12,
                      en: "December"
                  },
                  year: "2014",
                  designation: {
                      abbreviated: "AD",
                      expanded: "Anno Domini"
                  }
              }
          }
      }
  }

2. Request a Hijri Calendar for a Gregorian month - http://api.aladhan.com/v1/gToHCalendar/:month/:year

• Description:

  Request a Hijri Calendar for a Gregorian month

• Method: GET
• Parameters:
  • "month" (number) -

    A gregorian month. 1 = January and 12 = December.

  • "year" (number) -

    A gregorian year. Example: 2015

  • "adjustment" (number) -

    Number of days to adjust hijri date(s). Example: 1 or 2 or -1 or -2

• Endpoint URL: http://api.aladhan.com/v1/gToHCalendar/:month/:year
• Example Request: http://api.aladhan.com/v1/gToHCalendar/8/2016
• Example Response:

  HTTP/1.1 200 OK
  {
      code: 200,
      status: "OK",
      data: [
      {
          gregorian: {
              date: "01-12-2578",
              format: "DD-MM-YYYY",
              day: "01",
              weekday: {
                  en: "Tuesday"
              },
              month: {
                  number: 12,
                  en: "December"
              },
              year: "2578",
              designation: {
                  abbreviated: "AD",
                  expanded: "Anno Domini"
              }
          },
          hijri: {
              date: "01-06-2017",
              format: "DD-MM-YYYY",
              day: "01",
              weekday: {
                  en: "Al Thalaata",
                  ar: "الثلاثاء"
              },
              month: {
                  number: 6,
                  en: "Jumādá al-ākhirah",
                  ar: "جُمادى الآخرة"
              },
              year: "2017",
              designation: {
                  abbreviated: "AH",
                  expanded: "Anno Hegirae"
              },
              holidays: [ ]
          }
      },
  
      ...  more days
  
      ]
  }

3. Convert a Hijri date to a Gregorian date - http://api.aladhan.com/v1/hToG/:date

• Description:

  Convert a Hijri date to a Gregorian date

• Method: GET
• Parameters:
  • "date" (string) -

    A hijri date formatted as DD-MM-YYYY

  • "adjustment" (number) -

    Number of days to adjust hijri date(s). Example: 1 or 2 or -1 or -2

• Endpoint URL: http://api.aladhan.com/v1/hToG/:date
• Example Request: http://api.aladhan.com/v1/hToG/14-02-1436
• Example Response:

  HTTP/1.1 200 OK
  {
      {
          code: 200,
          status: "OK",
          data: {
              hijri: {
                  date: "14-02-1436",
                  format: "DD-MM-YYYY",
                  day: "14",
                  month: {
                      number: 2,
                      en: "Ṣafar",
                      ar: "صَفَر"
                  },
                  year: "1436",
                  designation: {
                      abbreviated: "AH",
                      expanded: "Anno Hegirae"
                  }
              },
              gregorian: {
                  date: "07-12-2014",
                  format: "DD-MM-YYYY",
                  day: "07",
                  month: {
                      number: 12,
                      en: "December"
                  },
                  year: "2014",
                  designation: {
                      abbreviated: "AD",
                      expanded: "Anno Domini"
                  }
              }
          }
      }
  }

4. Request a Gregoran Calendar for a Hijri month - http://api.aladhan.com/v1/hToGCalendar/:month/:year

• Description:

  Request a Gregorian Calendar for a Hijri month

• Method: GET
• Parameters:
  • "month" (number) -

    A Hijri month. 1 = Muharram and 12 = Dhu al Hijjah.

  • "year" (number) -

    A hijri year. Example: 1437

  • "adjustment" (number) -

    Number of days to adjust hijri date(s). Example: 1 or 2 or -1 or -2

• Endpoint URL: http://api.aladhan.com/v1/hToGCalendar/:month/:year
• Example Request: http://api.aladhan.com/v1/hToGCalendar/3/1438
• Example Response:

  HTTP/1.1 200 OK
  {
      code: 200,
      status: "OK",
      data: [
      {
          gregorian: {
              date: "01-12-2578",
              format: "DD-MM-YYYY",
              day: "01",
              weekday: {
                  en: "Tuesday"
              },
              month: {
                  number: 12,
                  en: "December"
              },
              year: "2578",
              designation: {
                  abbreviated: "AD",
                  expanded: "Anno Domini"
              }
          },
          hijri: {
              date: "01-06-2017",
              format: "DD-MM-YYYY",
              day: "01",
              weekday: {
                  en: "Al Thalaata",
                  ar: "الثلاثاء"
              },
              month: {
                  number: 6,
                  en: "Jumādá al-ākhirah",
                  ar: "جُمادى الآخرة"
              },
              year: "2017",
              designation: {
                  abbreviated: "AH",
                  expanded: "Anno Hegirae"
              },
              holidays: [ ]
          }
      },
  
      ...  more days
  
      ]
  }