GET /api/v1/enrich
Requires Bearer token.
address/lat+lng, company, or facility to select the mode.
Location enrichment
Enrich a US address (or lat/lng pair) with scores, permits, commuter data, nearby amenities, and hazards. Query parameters| Name | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | ✓* | Full US street address to geocode and enrich. | |
lat | float | ✓* | Latitude (use instead of address). | |
lng | float | ✓* | Longitude (use instead of address). | |
radius | float | 1.0 | Search radius in km (max 10). | |
profile | string | general | Scoring profile: general, qsr, self_storage, retail, office, data_center, industrial. | |
include | string | all | Comma-separated sections: scores, pois, permits, demographics, risk. Use all for everything. |
address or both lat and lng.
Example
curl "https://axiomlocus.io/api/v1/enrich?address=123+Market+St+San+Francisco+CA" \
-H "Authorization: Bearer al_your_key_here"
{
"location": {
"lat": 37.7935,
"lng": -122.3958,
"h3_index": "882a100d63fffff",
"metro": "sf",
"address": "123 Market St, San Francisco, CA 94105"
},
"scores": {
"composite": 76.2,
"profile": "general",
"confidence": 0.94,
"groups": {
"businessVitality": { "score": 82 },
"populationMomentum": { "score": 71 },
"demographics": { "score": 80 },
"economicStrength": { "score": 75 },
"developmentPipeline": { "score": 69 },
"accessibility": { "score": 88 },
"safetyEnvironment": { "score": 62 },
"amenityDemand": { "score": 79 }
}
},
"permit_activity": {
"count_12m": 34,
"momentum": "accelerating",
"dominant_type": "renovation",
"predicted_next": "new_construction",
"predicted_probability": 0.72
},
"crime_safety": {
"level": "moderate",
"severity_score": 42,
"incidents_90d": 18
},
"commuter_profile": {
"total_jobs": 14200,
"high_earners_pct": 38.5,
"top_sectors": ["Professional Services", "Information", "Finance"]
},
"nearby": {
"schools": 5,
"avg_school_quality": 7.2,
"pois": 120,
"clinical_trials": 8
},
"hazards": [
{ "type": "epa_non_compliant_facility", "value": "ABC Chemical Corp" }
],
"neighborhood": "Financial District"
}
| Field | Type | Description |
|---|---|---|
location | object | Geocoded coordinates, H3 cell index, and metro. |
scores | object | Full scoring breakdown with composite and all 8 signal groups. |
permit_activity | object | 12-month permit count, momentum, dominant type, and next-permit prediction. |
crime_safety | object | Safety level, severity score, and recent incident count. |
commuter_profile | object | LEHD-based commuter data: total jobs, high-earner percentage, top sectors. |
nearby | object | Counts of nearby schools, POIs, and clinical trials. |
hazards | array | Environmental hazards (e.g. EPA non-compliant facilities). |
neighborhood | string | Resolved neighborhood name. |
Company enrichment
Enrich a company name with supply chain fragility scoring, FDA compliance events, and predictive hazard analysis. Query parameters| Name | Type | Required | Description |
|---|---|---|---|
company | string | ✓ | Company name to look up. |
curl "https://axiomlocus.io/api/v1/enrich?company=Pfizer" \
-H "Authorization: Bearer al_your_key_here"
{
"company": "Pfizer",
"fragility_score": 32,
"risk_level": "low",
"component_scores": {
"regulatory": 28,
"supply_chain": 35,
"geographic_concentration": 30
},
"warning_letters": 2,
"drug_shortages": 1,
"hazard_predictions": [
{ "event": "shortage_escalation", "probability_90d": 0.12 },
{ "event": "warning_letter", "probability_90d": 0.08 }
],
"facilities": [
{
"name": "Pfizer McPherson Plant",
"lat": 38.371,
"lng": -97.664,
"sources": ["fda", "epa", "osha"],
"compliance_events": 4,
"entity_type": "manufacturing"
}
]
}
| Field | Type | Description |
|---|---|---|
fragility_score | number | Supply chain fragility index (0–100, lower is more resilient). |
risk_level | string | Risk classification: low, moderate, high, or critical. |
component_scores | object | Breakdown by regulatory, supply chain, and geographic concentration risk. |
warning_letters | number | Count of FDA warning letters. |
drug_shortages | number | Count of active drug shortages linked to this company. |
hazard_predictions | array | 90-day event probability forecasts derived from lead-lag correlation models. |
facilities | array | Known facilities with cross-referenced compliance data from FDA, EPA, and OSHA. |
Facility enrichment
Enrich a specific facility with OSHA inspection history, EPA compliance status, and FDA enforcement actions. Query parameters| Name | Type | Required | Description |
|---|---|---|---|
facility | string | ✓ | Facility name to look up. |
curl "https://axiomlocus.io/api/v1/enrich?facility=Pfizer+McPherson+Plant" \
-H "Authorization: Bearer al_your_key_here"
{
"facility": "Pfizer McPherson Plant",
"location": { "lat": 38.371, "lng": -97.664 },
"entity_type": "manufacturing",
"source_count": 3,
"compliance_events": 4,
"osha": {
"total": 2,
"recent": [
{
"activity_nr": "1234567",
"name": "Pfizer McPherson",
"violations": 1,
"penalty": 12500,
"date": "2025-09-15"
}
]
},
"epa": [
{
"id": "KSD001234567",
"name": "Pfizer McPherson Facility",
"compliance": "in_compliance",
"violations": 0,
"last_inspection": "2025-11-20"
}
],
"fda": {
"total": 2,
"recent": [
{
"id": "evt-abc123",
"type": "inspection",
"classification": "VAI",
"date": "2025-08-10"
}
]
}
}
| Field | Type | Description |
|---|---|---|
entity_type | string | Facility classification (e.g. manufacturing, warehouse, laboratory). |
source_count | number | Number of data sources with records for this facility. |
compliance_events | number | Total compliance events across all sources. |
osha | object | OSHA inspection history with violation counts and penalties. |
epa | array | EPA facility compliance status and inspection dates. |
fda | object | FDA enforcement actions and inspection classifications. |