> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrichment

> Enrich addresses, companies, and facilities with location intelligence from Axiom Locus — neighborhood scores, demographics, and POI density in a single call.

## `GET` `/api/v1/enrich`

<Note>Requires Bearer token.</Note>

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**

| 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. |

\*Provide either `address` or both `lat` and `lng`.

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/v1/enrich?address=123+Market+St+San+Francisco+CA" \
  -H "Authorization: Bearer al_your_key_here"
```

**Response**

```json theme={null}
{
  "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. |

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/v1/enrich?company=Pfizer" \
  -H "Authorization: Bearer al_your_key_here"
```

**Response**

```json theme={null}
{
  "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. |

**Example**

```bash theme={null}
curl "https://axiomlocus.io/api/v1/enrich?facility=Pfizer+McPherson+Plant" \
  -H "Authorization: Bearer al_your_key_here"
```

**Response**

```json theme={null}
{
  "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.                    |