Skip to main content
POST
/
api
/
v1
/
bulk_enhance
Start Bulk Enhance Job
curl --request POST \
  --url https://data-api.sovfixer.com/api/v1/bulk_enhance \
  --header 'Content-Type: application/json' \
  --data '
{
  "locations": [
    {
      "id": "<string>",
      "address": "<string>",
      "address_line_1": "<string>",
      "address_line_2": "<string>",
      "architectural_style": "<string>",
      "bldg_name": "<string>",
      "bq_id": "<string>",
      "city": "<string>",
      "company_ein": "<string>",
      "company_name": "<string>",
      "company_website": "<string>",
      "const__bldg_area": 123,
      "const__bldg_year_built": 123,
      "const__code_air": "<string>",
      "const__code_rms": "<string>",
      "const__num_stories": 123,
      "const__num_stories_below_gnd": 123,
      "const__roof_covering": "<string>",
      "const__wall_type": "<string>",
      "country": "<string>",
      "county": "<string>",
      "deductible_amount": 123,
      "deductible_amount2": 123,
      "deductible_amount3": 123,
      "deductible_type": 123,
      "dtc_include_coastline_within_miles": 123,
      "dtc_return_connected_coastlines": true,
      "geocode_confidence": 123,
      "geocode_precision": 123,
      "hurricane_basin": "<string>",
      "hurricane_name": "<string>",
      "hurricane_season": 123,
      "hurricane_year": 123,
      "insured_business_name": "<string>",
      "insured_name": "<string>",
      "latitude": 123,
      "lightbox_assessment_id": "<string>",
      "lightbox_parcel_id": "<string>",
      "lightbox_parcel_wkt": "<string>",
      "limits__bi_limit": 123,
      "limits__bpp_limit": 123,
      "limits__building_limit": 123,
      "limits__signs_and_other_limit": 123,
      "longitude": 123,
      "model_code": "<string>",
      "occupancy__code_air": "<string>",
      "occupancy__code_atc": "<string>",
      "occupancy__type_desc": "<string>",
      "postal_code": "<string>",
      "site_name": "<string>",
      "sources": [],
      "state": "<string>",
      "state_code": "<string>",
      "state_name": "<string>"
    }
  ],
  "callback_url": "<string>",
  "check_cache": true,
  "delegate_to": "<string>",
  "include_debug_attrs": false,
  "include_raw_request": false,
  "include_raw_response": false,
  "sources": [],
  "timeout": 300
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Body

​
locations
object[]
required
​
callback_url
string<uri> | null

Optional webhook URL for posting results. If provided, results will be provided upon completion in the same format as the GET /bulk_enhance response.

​
check_cache
boolean

If false, bypass the cache and force a fresh fetch from all datasources.

​
delegate_to
string | null

If set, delegate this request to another user (requires delegation permissions).

​
include_debug_attrs
boolean
default:false

If true, include cache metadata (is_cache_hit, persist_for) on each datasource result. Can be overridden per-location via datasource_config.

​
include_raw_request
boolean
default:false

If true, include the raw request sent to the datasource for non cache hits. Does not support all datasources.

​
include_raw_response
boolean
default:false

If true, include the datasource's original response.

​
sources
enum<string>[]

Specify any desired third-party data sources to include for this location.

Available options:
PG,
PH,
LB
​
timeout
number<double>
default:300

Seconds before giving up. If timeout is reached, it will finalize the batch and provide any data that was aggregated in time.

Response

​
id
string<uuid>
required

Newly-created request ID. Use this as the id for future requests.