Developer Portal

Getting Started

Welcome to the AASHTOWare OpenAPI community. Follow this step-by-step guide to begin the journey of system integration.

Hero Background

Step-by-step Guide to API Integration

Follow these steps to configure and run AASHTOWare OpenAPI. Most developers complete initial setup within 30 minutes.

Create an Account

Start by creating your account at the AASHTOWare Store. This is your gateway to accessing the Developer Portal and obtaining necessary licenses.

Action Required:

Visit the AASHTOWare Store to register or verify your account credentials.

Register at AASHTOWare Store →
  • Use your organizational email address
  • Complete all required profile information
  • Verify your email address when prompted
  • Save your credentials securely

Access the Developer Portal

Once your AASHTOWare Store account is confirmed, sign in to the Developer Portal using the same credentials.

Action Required:

Sign in to explore API documentation, test endpoints, and manage your subscriptions.

Sign In to Developer Portal → Explore Portal (No Sign-in) →

You can browse API documentation and explore capabilities without signing in, but you'll need to authenticate to access API keys and make actual API calls.

Obtain a License

To receive a subscription and access API endpoints, you must first order a license through the AASHTOWare Store.

License Options:

  • Member Agencies: No-cost access for AASHTO members with active AASHTOWare product licenses
  • Non-Members: Basic, Enhanced, or Premium options available
  • Technical Support: Optional support hours available in 4-hour blocks
Order License → View Catalog (PDF) →

Important

Once your license order is complete, our team will finalize your request and provide the required subscription. This typically takes 1-2 business days. You'll receive an email confirmation when your subscription is activated.

Get API Keys

When the AASHTOWare subscription is activated, return to the Developer Portal to generate API keys (subscription keys).

How to Get Your Keys:

  1. Sign in to the Developer Portal
  2. Navigate to Profile/Subscriptions
  3. Select active subscription
  4. Generate or view API keys
  5. Copy and store keys securely
Manage Subscriptions →

Maintaining API key security is important.

  • Never share your API keys publicly
  • Use environment variables to store keys
  • Rotate keys periodically for security
  • Monitor key usage through the portal dashboard

Make an API Call

Verify the setup is working correctly by initiating a simple test call.

Quick Test Example:

# Test your API connection
curl -X GET "https://api.aashtoware.org/awdemo/ping" \
     -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE"
Explore APIs → Technical Standards →

Familiarity with API technical standards will streamline integration.

Next Steps

  • Review specific use case API documentation
  • Download SDKs for preferred programming language(s)
  • Set up error handling and logging
  • Implement authentication flows
  • Start with read operations before attempting write operations

Quick References

The following links and resources are intended to accelerate API development and integration.

Authentication Guide

API Documentation

FAQs

Get Support

Still Have Questions?

Can't find the answer you're looking for? Our support team is ready to help you with any questions about AASHTOWare OpenAPI.

Contact Support →

AASHTOWare Alliance Manager

Shakita L. Battle-Morrow

American Association of State Highway
and Transportation Officials

555 12th Street NW, Suite 1000
Washington, DC 20004

Phone: (202) 624-8815

Email: sbattlemorrow@aashto.org

Technical Contact

Jagannath Mallela

WSP

Phone: (202) 783-0241

Email: jag.mallela@wsp.com