Welcome to the EMNRD Water Data Act (NMSA 1978, § 72-4B) APIs.
In 2019, New Mexico enacted NM House Bill 651 to enhance the sharing, integration, and accessibility of water data. The Water Data Act mandates the creation and maintenance of a comprehensive water data platform that integrates data from various state agencies, making it publicly accessible for better decision-making and resource management. The New Mexico Water Data Initiative (WDI), a key component of the act, aims to develop this integrated water data platform. As part of this initiative, the Energy, Minerals and Natural Resources Department (EMNRD) has developed the Water Data Act API project. These APIs offer powerful tools for developers, researchers, and organizations to access comprehensive water-related information.
To ensure responsible and secure usage, we require users to register before accessing our API data.
How to Register
- Create an Account: If you don't already have an account, start by creating one on our platform. Provide essential details to set up your profile.
- Confirm your Account: Before you can access your account, please confirm your email address by clicking the link sent to you during registration. This ensures that the provided email is valid and that you have control over it. This step enhances security by verifying the user's identity and reducing the risk of fraudulent or unauthorized access.
- API Access Request: Once logged in, navigate to the API Access Request section. Submit a request by providing information about your intended use, project details, and any specific requirements.
- Verification: Our team will review your request during normal business hours to ensure it aligns with our usage policies. This process may take a short time, and you will receive a notification once your request is approved.
- Access Credentials: Upon approval, you will be able to use these credentials to obtain a JSON Web Token (JWT) and Refresh Token needed to access the APIs. Keep this information secure, as it will be essential for authenticating your API requests.
- Testing and Documentation: Access our powerful tool for testing and viewing API documentation. We provide an interactive user interface that allows developers to visualize, explore, and test endpoints of an API in a user-friendly format, helping to ensure that the API behaves as expected and is well-documented.
API Usage Guidelines
- Responsible Use: Use the Water Data Act APIs responsibly and ethically. Avoid any activities that may compromise data integrity or the performance of the system.
- Rate Limiting: API access is restricted to a maximum of 600 requests per 1 minute per user. This rolling limit means that if a user exceeds this threshold, they will receive a 429 "Too Many Requests" error. The limit is designed to support continuous sequential API calls on a single thread. However, using multiple threads will quickly exceed the allowed limit, leading to rate limiting.
- Stay Informed: Regularly check for updates and announcements related to the APIs. We may release new features or updates to enhance your experience.
- Feedback: Share your feedback with us. If you encounter any issues or have suggestions for improvement, we welcome your input. Contact Support
Get Started Today!
Unlock the full potential of water data by registering for API access. Join a community of users dedicated to harnessing the power of water data for a sustainable future. If you have any questions or need assistance during the registration process, our support team is here to help.
Register now and dive into the world of water data with our Water Data Act APIs!
Already have an account? Login