Skip to main content

​
GET /api/v1/enrich

Requires Bearer token.
The enrich endpoint supports three query modes. Pass one of 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
NameTypeRequiredDefaultDescription
addressstring✓*Full US street address to geocode and enrich.
latfloat✓*Latitude (use instead of address).
lngfloat✓*Longitude (use instead of address).
radiusfloat1.0Search radius in km (max 10).
profilestringgeneralScoring profile: general, qsr, self_storage, retail, office, data_center, industrial.
includestringallComma-separated sections: scores, pois, permits, demographics, risk. Use all for everything.
*Provide either 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"
Response 
{
  "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"
}
FieldTypeDescription
locationobjectGeocoded coordinates, H3 cell index, and metro.
scoresobjectFull scoring breakdown with composite and all 8 signal groups.
permit_activityobject12-month permit count, momentum, dominant type, and next-permit prediction.
crime_safetyobjectSafety level, severity score, and recent incident count.
commuter_profileobjectLEHD-based commuter data: total jobs, high-earner percentage, top sectors.
nearbyobjectCounts of nearby schools, POIs, and clinical trials.
hazardsarrayEnvironmental hazards (e.g. EPA non-compliant facilities).
neighborhoodstringResolved neighborhood name.

​
Company enrichment

Enrich a company name with supply chain fragility scoring, FDA compliance events, and predictive hazard analysis. Query parameters
NameTypeRequiredDescription
companystring✓Company name to look up.
Example 
curl "https://axiomlocus.io/api/v1/enrich?company=Pfizer" \
  -H "Authorization: Bearer al_your_key_here"
Response 
{
  "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"
    }
  ]
}
FieldTypeDescription
fragility_scorenumberSupply chain fragility index (0–100, lower is more resilient).
risk_levelstringRisk classification: low, moderate, high, or critical.
component_scoresobjectBreakdown by regulatory, supply chain, and geographic concentration risk.
warning_lettersnumberCount of FDA warning letters.
drug_shortagesnumberCount of active drug shortages linked to this company.
hazard_predictionsarray90-day event probability forecasts derived from lead-lag correlation models.
facilitiesarrayKnown 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
NameTypeRequiredDescription
facilitystring✓Facility name to look up.
Example 
curl "https://axiomlocus.io/api/v1/enrich?facility=Pfizer+McPherson+Plant" \
  -H "Authorization: Bearer al_your_key_here"
Response 
{
  "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"
      }
    ]
  }
}
FieldTypeDescription
entity_typestringFacility classification (e.g. manufacturing, warehouse, laboratory).
source_countnumberNumber of data sources with records for this facility.
compliance_eventsnumberTotal compliance events across all sources.
oshaobjectOSHA inspection history with violation counts and penalties.
epaarrayEPA facility compliance status and inspection dates.
fdaobjectFDA enforcement actions and inspection classifications.