Introduction
The Nepali Date Conversion API provides a simple and reliable way to convert dates between the Bikram Sambat (BS) calendar and the Gregorian (AD) calendar. This API is perfect for applications that need to handle Nepali dates accurately.
Copy-paste JavaScript, Python, PHP code snippets and iframe embed examples
https://sudhanparajuli.com.np/api
            Features for Developers & AI Coders
- ✅ Convert AD (Gregorian) to BS (Bikram Sambat) dates
- ✅ Convert BS (Bikram Sambat) to AD (Gregorian) dates
- ✅ RESTful API with JSON responses
- ✅ GET endpoints - no authentication required
- ✅ CORS enabled for browser/web applications
- ✅ Iframe widget for easy embedding
- ✅ Perfect for ChatGPT and AI model integration
- ✅ Comprehensive error handling
- ✅ Works with all programming languages
Perfect for AI Applications
This API is designed to be easily discoverable and usable by AI models like ChatGPT, Claude, and other AI coders. The endpoints are intuitive, responses are consistent, and no API keys are required.
Rate Limits
Currently, there are no rate limits imposed on the API. However, please use the API responsibly and avoid excessive requests.
Authentication
No authentication is required to use this API. All endpoints are publicly accessible.
API Endpoints
All endpoints return JSON responses. The API supports GET methods for date conversion.
                    GET
                    /api/bs-to-ad/{year}/{month}/{day}
                
                Convert BS date to AD date using URL parameters.
URL Parameters
| Parameter | Type | Description | 
|---|---|---|
| year | integer | BS year | 
| month | integer | BS month (1-12) | 
| day | integer | BS day (1-31) | 
Example Request
GET /api/bs-to-ad/2080/1/1Response
{
  "success": true,
  "input": {
    "year": 2080,
    "month": 1,
    "day": 1,
    "type": "BS"
  },
  "result": {
    "year": 2023,
    "month": 4,
    "day": 13,
    "type": "AD"
  }
}
                    GET
                    /api/ad-to-bs/{year}/{month}/{day}
                
                Convert AD date to BS date using URL parameters.
URL Parameters
| Parameter | Type | Description | 
|---|---|---|
| year | integer | AD year | 
| month | integer | AD month (1-12) | 
| day | integer | AD day (1-31) | 
Example Request
GET /api/ad-to-bs/2023/4/13Response
{
  "success": true,
  "input": {
    "year": 2023,
    "month": 4,
    "day": 13,
    "type": "AD"
  },
  "result": {
    "year": 2080,
    "month": 1,
    "day": 1,
    "type": "BS"
  }
}Quick Code Example
Choose a language to see how to call the GET endpoints.
# BS to AD
curl https://sudhanparajuli.com.np/api/bs-to-ad/2080/1/1
# AD to BS
curl https://sudhanparajuli.com.np/api/ad-to-bs/2023/4/13Error Handling
The API uses standard HTTP status codes to indicate success or failure of requests.
HTTP Status Codes
| Status Code | Description | 
|---|---|
| 200 | Success | 
| 400 | Bad Request - Invalid input data | 
| 404 | Not Found - Endpoint not found | 
| 500 | Internal Server Error | 
Error Response Format
{
  "error": "Error message description"
}Common Error Messages
- "No JSON data provided"- POST request missing JSON body
- "Missing required fields. Provide 'type', 'year', 'month', and 'day'."- Missing required parameters
- "Invalid date type. Use 'BS_to_AD' or 'AD_to_BS'."- Invalid conversion type
- "Invalid date values: [error details]"- Invalid date format or values
- "Date conversion failed"- Internal conversion error
Support & Contact
If you have any questions, issues, or suggestions regarding the API, please feel free to reach out:
- GitHub: @SudhanParajuli
- LinkedIn: Sudhan Parajuli
- Twitter: @sudhanparajuli0