KratomBans.com API
Access kratom legal status data programmatically. Perfect for merchants building compliance tools, checkout validation, and more.
Endpoints
Get State by Slug
GET /api/status/[state]Returns detailed information for a specific state, including county restrictions.
Example: /api/status/california
Response Format
{
"state": "California",
"stateCode": "CA",
"slug": "california",
"status": "RESTRICTED",
"ageRestriction": 21,
"effectiveDate": "2024-01-01",
"lastUpdated": "2025-12-15T00:00:00.000Z",
"lastVerified": "2025-12-15T00:00:00.000Z",
"summary": "Legal statewide with age restriction",
"countyRestrictions": [
{
"countyName": "San Diego",
"status": "BANNED",
"details": "Board voted to ban sales",
"effectiveDate": "2026-01-15"
}
]
}Usage Example
// Check if kratom can be shipped to a state
const response = await fetch('https://kratombans.com/api/status/california');
const data = await response.json();
if (data.status === 'BANNED') {
alert('Cannot ship to California - kratom is banned');
}
// Check county restrictions
const county = data.countyRestrictions.find(
c => c.countyName === userCounty && c.status === 'BANNED'
);
if (county) {
alert(`Cannot ship to ${county.countyName} County`);
}Why Choose KratomBans.com API?
Only Source for Kratom Legal Status API
The only API providing comprehensive kratom legal status data across all 50 states.
County-Level Detail
Most APIs don't go this granular. We track restrictions down to the county and city level.
Lower risk of Compliance Violations
High-stakes use case. Block illegal shipments before they happen, protecting your business.
Real-Time Updates
Automated monitoring ensures your data stays current. Legal changes reflected within 24 hours.
Critical for Checkout Validation
Integrate directly into your checkout flow to verify legality by customer IP or address in real-time. (Need help with integration?)
API Access Tiers
Free
$0/month
- 10 requests/day
- All endpoints
- Community support
No API key required. Just start making requests.
Pro
$99/month
- Unlimited requests
- Dedicated API key
- Priority email support
- Real-time updates
Authentication
Pro and Enterprise users authenticate using an API key. Include it in your requests. This is for the public API (status, stats, updates); use X-API-Key with your subscriber API key. Admin/backend APIs use X-Admin-Key (or an admin API key in X-API-Key) and do not accept subscriber keys.
Option 1: Header (recommended)
curl -H "X-API-Key: kb_pro_your_api_key_here" \
https://kratombans.com/api/statusOption 2: Query parameter
https://kratombans.com/api/status?api_key=kb_pro_your_api_key_here