API Documentation

Build amazing applications with the Minnesota Business Directory API

RESTful API

Simple and intuitive REST endpoints

Secure

API key authentication with HTTPS

Rate Limited

1000 requests per hour per key

JSON Format

Clean JSON responses with pagination

Getting Started

1. Ask for an API key

Keys are issued by hand while the API is in pilot. There is no self-service signup that produces a working key, and creating an account on its own does not get you one. Tell us what you are building and we reply by email with a key and the rate limit that applies to it.

2. Make Your First Request

Include your API key in the X-API-Key header:

curl -X GET "$API_BASE_URL/businesses" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json"

3. Handle Responses

All responses are in JSON format with consistent structure:

{
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}

Base URL

https://thisis.mn/api/v1

Rate Limiting

Rate Limits

API requests are limited to 1000 per hour per API key. Rate limit information is included in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

Need Help?

Check out our resources or contact our developer support team.