Enrich up to 50 UK companies in a single request.

Accepts a JSON body with a list of company numbers and returns an enriched profile for each one. Results are fetched in parallel and served from the 30-day cache where available.

Partial success - each item in the response has its own status field. If one company number is invalid or not found, the rest still succeed. Inspect each item individually.

Credits - this endpoint charges credits_used = N where N is the number of company numbers in the request, regardless of cache hits or errors.

Example request:

POST /v1/enrich
{"company_numbers": ["00445790", "03547512"]}

Example response (one success, one not found):

{
  "status": "success",
  "credits_used": 2,
  "data": [
    {"company_number": "00445790", "status": "success", "data": {...}},
    {"company_number": "99999999", "status": "error", "error": "Company 99999999 not found"}
  ]
}

---

Cache behaviour: Companies already in cache are returned instantly at no upstream cost. Cache TTL is 30 days (same as GET /v1/company/{n}).

{
  "company_numbers": [
    "00445790",
    "03547512"
  ]
}

{
  "cache_age_seconds": 3421,
  "cached": true,
  "credits_remaining": 487,
  "credits_used": 1,
  "data": {
    "company_age_years": 78,
    "company_name": "TESCO PLC",
    "company_number": "00445790",
    "company_status": "active",
    "company_type": "plc"
  },
  "data_source": "cached",
  "status": "success"
}