> ## Documentation Index > Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt > Use this file to discover all available pages before exploring further. # Start Bulk Enhance Job > Enhance a list of locations with additional data. ## OpenAPI ````yaml https://data-api-staging.sovfixer.com/api/schema/?format=json post /api/v1/bulk_enhance openapi: 3.0.3 info: title: Ping.Data API version: v1.0 description: > ### Ping.Data API This API provides convenient, efficient access to bulk location data from many sources. The typical usage flow is: * POST to `/api/v1/bulk_enhance`. The POST body should look like this: ``` { "locations": [ { "id": "user-id1", "address": "1212 Ping Data Lane, Pingville, FL", "sources": ["PG", "PH"], ... }, ... ], "timeout": 60.0, } ``` * Poll GET `/api/v1/bulk_enhance/{id}`, passing the `id` given by the previous response until `response.request.status` is `COMPLETE` or `FAILED`. * Download the data as JSON from `/api/v1/sov/{id}/output/{filename}`. The exact url comes from the response to the above query, in `response.result.outputs[].url`. Output JSON Example: ``` { "user-id1": { "GG": { "is_success": true, "error_message": null, "confidence": 80, "status_code": 200, "fetch_time": 4.754, "street_number": "1212", "route": "Ping Data Ln", "location_type": "ROOFTOP", "latitude": 28.xxx, "longitude": -81.xxx, "formatted_address": "1212 Ping Data Lane, Pingville, FL, USA", "place_id": "xxx-yyy", "address_line_1": "1212 Ping Data Lane", "address_line_2": "", "city": "Pingville", "postal_code": "00010", "county": "Pingville", "state": "FL", "country": "US" }, "HH": { "is_success": true, "error_message": null, "confidence": null, "status_code": null, "latitude": 28.xxx, "longitude": -81.xxx, "geocode_type": "ADDRESS", "google_maps_link": "https://www.google.com/maps/search/?api=1&query=28.xxx,-81.xxx", "fema_flood_zone": "X", "elevation": null, "bldg_year_built": 2009, ... more attributes ... } }, ... more buildings ... } ``` contact: email: support@pingintel.com name: Ping Intel url: https://www.pingintel.com servers: - url: https://data-api.sovfixer.com description: Ping.Data API - url: https://data-api-staging.sovfixer.com description: Ping.Data API (staging) security: [] paths: /api/v1/bulk_enhance: post: tags: - Bulk Enhance summary: Start Bulk Enhance Job description: Enhance a list of locations with additional data. operationId: api_v1_bulk_enhance_create requestBody: content: application/json: schema: $ref: '#/components/schemas/BulkEnhanceRequest' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/BulkEnhanceRequest' multipart/form-data: schema: $ref: '#/components/schemas/BulkEnhanceRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/BulkEnhanceResponse' description: '' '401': content: application/json: schema: $ref: '#/components/schemas/BulkEnhanceErrorResponse' description: '' '409': content: application/json: schema: $ref: '#/components/schemas/BulkEnhanceErrorResponse' description: '' components: schemas: BulkEnhanceRequest: type: object properties: locations: type: array items: $ref: '#/components/schemas/Location' callback_url: type: string format: uri nullable: true description: >- 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: type: boolean description: >- If false, bypass the cache and force a fresh fetch from all datasources. delegate_to: type: string nullable: true description: >- If set, delegate this request to another user (requires delegation permissions). include_raw_response: type: boolean default: false description: If true, include the datasource's original response. sources: type: array items: type: string enum: - PG - PH - LB description: >- Specify any desired third-party data sources to include for this location. timeout: type: number format: double default: 300 description: >- Seconds before giving up. If timeout is reached, it will finalize the batch and provide any data that was aggregated in time. required: - locations BulkEnhanceResponse: type: object properties: id: type: string format: uuid description: Newly-created request ID. Use this as the id for future requests. required: - id BulkEnhanceErrorResponse: type: object properties: message: type: string description: Authorization error message required: - message Location: type: object properties: id: type: string item_id: type: string readOnly: true description: >- Identifier for this location, supplied and returned as 'id' in the API. address: type: string nullable: true description: Street address in any standard format. address_line_1: type: string nullable: true description: Street address line 1. address_line_2: type: string nullable: true description: Street address line 2, e.g. suite, unit, or floor. architectural_style: type: string nullable: true description: >- Architectural style of the building (e.g. 'Victorian', 'Ranch', 'Contemporary'). bldg_name: type: string nullable: true description: Building name (e.g. 'Empire State Building'). city: type: string nullable: true description: City name. company_ein: type: string nullable: true description: Company Employer Identification Number (EIN). company_name: type: string nullable: true description: Company name. company_website: type: string nullable: true description: Company website URL. const__bldg_area: type: integer nullable: true description: Building usable area (sq ft). const__bldg_year_built: type: integer nullable: true description: Year the building was constructed. const__code_air: type: string nullable: true description: AIR construction code. const__code_rms: type: string nullable: true description: RMS construction code. const__desc_ping: enum: - Automobiles - Automobiles - Bridges - Conventional - Continuous Bridges - Bridges - Conventional - Multiple Span Bridges - Bridges - General - Concrete (Non-Seismic or Seismic) Bridge - Bridges - General - Steel (Non-Seismic or Seismic) Bridge - Bridges - Major Bridge (Non-Seismic or Seismic) - Bridges - Major Bridges - >- Bridges - Multi-Span - Continuous (Non-Seismic or Seismic) Concrete Bridge - >- Bridges - Multi-Span - Continuous (Non-Seismic or Seismic) Steel Bridge - >- Bridges - Multi-Span - Simply Supported (Non-Seismic or Seismic) Concrete Bridge - >- Bridges - Multi-Span - Simply Supported (Non-Seismic or Seismic) Steel Bridge - Bridges - Single Span (Non-Seismic or Seismic) Bridge - Bridges - Unknown Bridge (Non-Seismic or Seismic) - Cash In Transit - Cash being transferred - Chimneys - Concrete Chimneys - Chimneys - Masonry Chimneys - Chimneys - Steel Chimneys - Concrete - Pre-cast Concrete - Concrete - Pre-cast Concrete with Shear Wall - Concrete - Reinforced Concrete - Concrete - Reinforced Concrete MRF - Concrete - Reinforced Concrete MRF - Ductile - Concrete - Reinforced Concrete MRF - Non-Ductile - Concrete - Reinforced Concrete MRF with URM - Concrete - Reinforced Concrete Shear Wall (with MRF) - Concrete - Reinforced Concrete Shear Wall (without MRF) - Concrete - Tilt-Up - Dams - Concrete Dams - Dams - Earthfill Dams - Equipment - Electrical Equipment - Equipment - High Technology Equipment - Equipment - Mechanical Equipment - Equipment - Office Equipment - Equipment - Residential Equipment - Equipment - Thermal Power Plant - Equipment - Trains, Trucks, Airplanes - Fine Art & Collectibles - Paintings, frames, sculpture, etc. - >- General Specie - Statuettes, ornamental articles, fibers, arts and crafts, etc. - >- Jewellers Block - Jewels, engravings and valuable metals and stones - Marine Assets - Break Bulk Cargo - Marine Assets - Chemical Products - Marine Assets - Consumables - Marine Assets - Electronics Cargo - Marine Assets - Explosives Cargo - Marine Assets - General Cargo - Marine Assets - Heavy Industry Cargo - Marine Assets - Light Industry Cargo - Marine Assets - Livestock being shipped - Marine Assets - Marine Assets Automobiles - Marine Assets - Marine Assets Dry Bulk Cargo - Marine Assets - Marine Assets Liquid Bulk Cargo - Marine Assets - Petroleum Products - Marine Assets - Pharmaceuticals - Marine Assets - Project Cargos - Marine Assets - Temperature-Controlled Cargo - Marine Cargo - Carpool - Marine Cargo - Combustible - Carpool - Marine Cargo - Combustible - Dry Bulk Cargo - Marine Cargo - Combustible - General and Containerized Cargo - Marine Cargo - Combustible - Heavy Cargo - Marine Cargo - Combustible - Liquid Bulk Cargo - Marine Cargo - Combustible - Refrigerated Cargo - Marine Cargo - Dry Bulk Cargo - Marine Cargo - General and Containerized Cargo - Marine Cargo - General/Unknown - Marine Cargo - Heavy Cargo - Marine Cargo - Liquid Bulk Cargo - Marine Cargo - Non-Combustible - Carpool - Marine Cargo - Non-Combustible - Dry Bulk Cargo - Marine Cargo - Non-Combustible - General and Containerized Cargo - Marine Cargo - Non-Combustible - Heavy Cargo - Marine Cargo - Non-Combustible - Liquid Bulk Cargo - Marine Cargo - Non-Combustible - Refrigerated Cargo - Marine Cargo - Refrigerated Cargo - Marine Cargo - Unknown Marine Cargo - Combustible - Marine Cargo - Unknown Marine Cargo - Non-Combustible - Marine Craft (Boats and Yachts) - Pleasure Boats and Yachts - >- Marine Craft (Boats and Yachts) - Pleasure Boats and Yachts - Power Boats - >- Marine Craft (Boats and Yachts) - Pleasure Boats and Yachts - Sail Boats - Masonry - Adobe - Masonry - Cavity Double Brick - Masonry - Confined Masonry - Masonry - Joisted Masonry - Masonry - Masonry - Masonry - Reinforced Masonry - Masonry - Reinforced Masonry Shear Wall (with MRF) - Masonry - Reinforced Masonry Shear Wall (without MRF) - Masonry - Rubble Stone Masonry - Masonry - Unreinforced Masonry - Bearing Frame - Masonry - Unreinforced Masonry - Bearing Wall - Miscellaneous - Canals - Miscellaneous - Compressor Stations - Miscellaneous - Conveyor Systems - Miscellaneous - Cranes - Miscellaneous - Earth Retaining Structures - Miscellaneous - Marine Hull - Miscellaneous - Offshore Structures - Miscellaneous - Pumping Stations - Miscellaneous - Railway Property (not valid in the United states) - Miscellaneous - Transit Warehouse - Miscellaneous - Waterfront Structures - Mobile Homes - Mobile Home with Full Tie-Downs - Mobile Homes - Mobile Home with No Tie-Downs - Mobile Homes - Mobile Home with Partial Tie-Downs - Mobile Homes - Mobile Homes - Offshore Assets - Caisson - Offshore Assets - Compliant Tower - Offshore Assets - Drill Rig - Offshore Assets - Drill Ship - Offshore Assets - Fixed Jacket Platform - Offshore Assets - Jackup - Offshore Assets - Mini Tension Leg Platform (MTLP) - Offshore Assets - Offshore Wind Turbines - Offshore Assets - SPAR Floating Production System - Offshore Assets - Semi-Submersible Floating Production System - Offshore Assets - Submersible Production System - Offshore Assets - Tension Leg Platform - >- Offshore Assets - Underwater Production Units, Completion Units, and Templates - Offshore Assets - Unknown - Offshore Assets - Well Protector - Pavements - Highways - Pavements - Railroads - Pavements - Runways - Pipelines - At Grade Asbestos Cement Pipelines - Pipelines - At Grade Cast Iron Pipelines - Pipelines - At Grade Concrete Pipelines - Pipelines - At Grade Ductile Iron Pipelines - Pipelines - At Grade PVC Pipelines - Pipelines - At Grade Pipelines - Pipelines - General At Grade Pipelines - Pipelines - General Underground Pipelines - Pipelines - Underground Asbestos Cement Pipelines - Pipelines - Underground Cast Iron Pipelines - Pipelines - Underground Concrete Pipelines - Pipelines - Underground Ductile Iron Pipelines - Pipelines - Underground PVC Pipelines - Pipelines - Underground Pipelines - Pipelines - Unknown Pipeline - Special - Impact Resistance Glass - Special - Long Span - Special - Safety Glass - Special - Semi-Wind Resistive - Special - Unknown Glass - Special - Wind Resistive - Steel - Braced Steel Frame - Steel - Light Metal - Steel - Steel - Steel - Steel Frame with Concrete Shear Wall - Steel - Steel Frame with URM - Steel - Steel Long Span - Steel - Steel MRF - Steel - Steel MRF - Distributed - Steel - Steel MRF - Perimeter - Steel - Steel Reinforced Concrete - Storage Tanks - Elevated Concrete Liquid Tanks (2000 series) - Storage Tanks - Elevated Concrete Solid Tanks - Storage Tanks - Elevated Liquid Tanks - Storage Tanks - Elevated Liquid Tanks (2000 series) - Storage Tanks - Elevated Solid Tanks - Storage Tanks - Elevated Solid Tanks (2000 series) - Storage Tanks - Elevated Steel Liquid Tanks - Storage Tanks - Elevated Steel Solid Tanks - Storage Tanks - On Ground Concrete Liquid Tanks - Storage Tanks - On Ground Concrete Solid Tanks - Storage Tanks - On Ground Liquid Tanks - Storage Tanks - On Ground Liquid Tanks (2000 series) - Storage Tanks - On Ground Solid Tanks - Storage Tanks - On Ground Solid Tanks (2000 series) - Storage Tanks - On Ground Steel Liquid Tanks - Storage Tanks - On Ground Steel Solid Tanks - Storage Tanks - Underground Liquid Tanks - Storage Tanks - Underground Liquid Tanks (2000 series) - Storage Tanks - Underground Solid Tanks - Storage Tanks - Underground Solid Tanks (2000 series) - Storage Tanks - Unknown Tanks - Towers - Broadcast Towers - Towers - Electrical Transmission - Conventional - Towers - Electrical Transmission - Major - Towers - Observation Towers - Towers - Offshore Towers - Tunnels - Alluvial Bored Tunnels - Tunnels - Alluvial Cut and Cover Tunnels - Tunnels - Alluvium Tunnels - Tunnels - Alluvium Tunnels (2000 series) - Tunnels - Cut and Cover Tunnels - Tunnels - Rock Bored Tunnels - Tunnels - Rock Cut and Cover Tunnels - Tunnels - Rock Tunnels - Tunnels - Rock Tunnels (2000 series) - Tunnels - Unknown Tunnel - Unknown - Wood - Hale Construction (Indigenous Hawaii) - Wood - Heavy Timber - Wood - Light Wood Frame - Wood - Lightweight Cladding - Wood - Masonry Veneer - Wood - Wood Frame (Modern) - null type: string x-spec-enum-id: 5114c8bf5c13930f nullable: true description: Construction type using Ping's taxonomy. const__num_stories: type: number format: double nullable: true description: Number of above-grade floors. const__num_stories_below_gnd: type: integer nullable: true description: Number of below-grade floors. const__roof_covering: type: string nullable: true description: >- Roof covering material type (e.g. 'Tile', 'Metal', 'Asphalt Shingle'). const__wall_type: type: string nullable: true description: Exterior wall type (e.g. 'Masonry', 'Frame', 'Concrete'). country: type: string nullable: true description: Country name or ISO code. county: type: string nullable: true description: County name. datasource_config: type: object additionalProperties: {} deductible_amount: type: number format: double nullable: true description: Primary deductible amount (USD). deductible_amount2: type: number format: double nullable: true description: Secondary deductible amount (USD). deductible_amount3: type: number format: double nullable: true description: Tertiary deductible amount (USD). deductible_type: type: integer nullable: true description: 'Deductible type: 1=Building, 2=Contents, 3=Business Interruption.' dtc_include_coastline_within_miles: type: number format: double nullable: true description: >- Distance-to-coast: include coastlines within this many miles of the location. dtc_return_connected_coastlines: type: boolean nullable: true description: >- Distance-to-coast: if true, return all connected coastlines rather than only the nearest. geocode_confidence: type: integer nullable: true description: Geocoding confidence score (0–100). geocode_precision: type: integer nullable: true description: Geocoding precision level (0-100). hurricane_basin: type: string nullable: true description: >- Filter historical hurricane track results by basin (e.g. 'Atlantic', 'Gulf'). hurricane_name: type: string nullable: true description: >- Filter historical hurricane track results by storm name (e.g. 'Katrina'). hurricane_season: type: integer nullable: true description: >- Filter historical hurricane tracks by the season the storm is assigned to (e.g. 2005). A storm forming in late November may carry track points into the following calendar year. hurricane_year: type: integer nullable: true description: >- Filter historical hurricane tracks by the calendar year of the individual track point (e.g. 2005). Use hurricane_season to filter by the storm's assigned season instead. insured_business_name: type: string nullable: true description: Business name of the insured. insured_name: type: string nullable: true description: Name of the insured. latitude: type: number format: double nullable: true description: >- Latitude (decimal degrees). Either supplied directly, or derived from address by a geocoding source (e.g. PG). Required upstream input for hazard and risk datasources. lightbox_assessment_id: type: string nullable: true description: Lightbox assessment identifier. lightbox_parcel_id: type: string nullable: true description: Lightbox parcel identifier. lightbox_parcel_wkt: type: string nullable: true description: Lightbox parcel boundary geometry in WKT format. limits__bi_limit: type: number format: double nullable: true description: Business Interruption coverage limit (USD). limits__bpp_limit: type: number format: double nullable: true description: Business Personal Property (contents) coverage limit (USD). limits__building_limit: type: number format: double nullable: true description: Building coverage limit (USD). limits__signs_and_other_limit: type: number format: double nullable: true description: Signs and other structures coverage limit (USD). longitude: type: number format: double nullable: true description: >- Longitude (decimal degrees). Either supplied directly, or derived from address by a geocoding source (e.g. PG). Required upstream input for hazard and risk datasources. model_code: type: string nullable: true description: Catastrophe model code. Omit to use the default model. occupancy__code_air: type: string nullable: true description: AIR occupancy code. occupancy__code_atc: type: string nullable: true description: ATC/RMS occupancy code. occupancy__desc_ping: enum: - Commercial - Construction/Erection Risks - Commercial - Entertainment and Recreation - Commercial - General Commercial - Commercial - Golf Courses - Commercial - Health Care Services - Commercial - Inland Transit Cargo - Commercial - Parking - Commercial - Personal and Repair Services - Commercial - Professional, Technical, and Business Services - Commercial - Retail Trade - Commercial - Wholesale Trade - Education - Primary and Secondary Schools - Education - Universities, Colleges, and Technical Schools - Government - Government - Emergency Services - Government - Government - General Services - Industrial - Chemical Processing - Industrial - Construction - Industrial - Construction/Erection Risks - Industrial - Food and Drug Processing - Industrial - General Industrial - Industrial - Heavy Fabrication and Assembly - Industrial - High-Technology - Industrial - Light Fabrication and Assembly - Industrial - Metal and Minerals Processing - Industrial - Mining - Industrial - Petroleum - Industrial Facility - Agriculture Systems - General - Industrial Facility - Airport Systems - General - Industrial Facility - Apparel and Finished Products from Fabrics - Industrial Facility - Automotive Manufacturing - >- Industrial Facility - Biological Products (Except Diagnostic) Medicinals/Botanicals/Biomedical - Industrial Facility - Business Systems - General - Industrial Facility - Cement Plants/Cement Mills - Industrial Facility - Chemical Processing - General - Industrial Facility - Chlorine Plants - Industrial Facility - Chlorohydrin Plants - Industrial Facility - Coal Mining - Industrial Facility - Communication Systems - General - Industrial Facility - Computer Storage Devices - Industrial Facility - Electric Substations - Industrial Facility - Electron Tubes - Industrial Facility - Electronic Computer Devices - >- Industrial Facility - Electronic and Other Electrical Equipment (Except Computer Equipment) - Industrial Facility - Fabricated Metal Products - Industrial Facility - Ferry Systems - Industrial Facility - Fertilizer Plants - Industrial Facility - Food and Drug Processing - General - Industrial Facility - Food and Kindred Products - Industrial Facility - Furniture and Fixtures - Industrial Facility - Gas Processing Systems - General - Industrial Facility - General Building/Construction Contractors - Industrial Facility - Heavy Constructions - Industrial Facility - Heavy Fabrication and Assembly - General - Industrial Facility - High-Technology - General - Industrial Facility - Hydro-Electric Power Systems - General - >- Industrial Facility - Industrial and Commercial Machinery and Equipment - Industrial Facility - Leather and Leather Products - Industrial Facility - Light Fabrication and Assembly - General - Industrial Facility - Light Hydrocarbon or Aromatics Plants - Industrial Facility - Lumber and Wood Products (Except Furniture) - >- Industrial Facility - Measuring, Analyzing, and Controlling Instruments - Industrial Facility - Metal Mining - Industrial Facility - Metal and Minerals Processing - General - Industrial Facility - Mining - General - Industrial Facility - Mining Operations - >- Industrial Facility - Mining/Quarrying - Non-Metallic Mineral (Except Fuels) - Industrial Facility - Miscellaneous Manufacturing Industries - Industrial Facility - Nuclear Power Systems - General - Industrial Facility - Oil Refinery Systems - General - Industrial Facility - Other Chemical and Allied Products - Industrial Facility - Pharmaceutical Plants - Industrial Facility - Photographic, Medical, and Optical Goods - Industrial Facility - Plastics Plants - Industrial Facility - Port Systems - Industrial Facility - Potable Water Systems - General - Industrial Facility - Primary Metal Industry - Industrial Facility - Print/Publishing and Allied Industries - Industrial Facility - Printed Circuit Boards - Industrial Facility - Pulp/Paper and Allied Products Manufacturing - Industrial Facility - Rubber and Miscellaneous Plastics Products - Industrial Facility - Semi-Conductor and Related Devices - Industrial Facility - Smelters - Industrial Facility - Special Trade Contractors - Industrial Facility - Steel Mills - Industrial Facility - Stone/Clay/Glass/Ceramics Products - Industrial Facility - Textile Mill Products - Industrial Facility - Thermo-Electric Power Systems - General - Industrial Facility - Tire Manufacturers - Industrial Facility - Tobacco Products - Industrial Facility - Transportation Equipment Assembly - Industrial Facility - Unknown Industrial Facility - Industrial Facility - Vinyl Plants - Industrial Facility - Waste Water Treatment Systems - General - Industrial Facility - Watches and Clocks - Industrial Facility - Wineries - Mercantile - Automotive Repair Shops and Car Washes - Mercantile - Gasoline Stations - Miscellaneous - Agriculture - Miscellaneous - At Destination Retail - Miscellaneous - At Destination in Warehouse - Miscellaneous - Communication - Miscellaneous - Construction/Erection Risks - Miscellaneous - Containerized Inside Warehouse - Miscellaneous - Containerized Stacked Outside - Miscellaneous - Designated Facilities / Vaults - Miscellaneous - Flood Control - Miscellaneous - Forestry - Miscellaneous - Gas Tanks - Miscellaneous - Greenhouses - Miscellaneous - Inside Warehouse At Port - Miscellaneous - Liquid Tanks - Miscellaneous - Museums, Institutions, Public Buildings - Miscellaneous - Open Lot or Stockpiled Outside - Miscellaneous - Retail & Private Buildings - Miscellaneous - Silo - Offshore - Drilling - Offshore - Gas Production Only - Offshore - No Production - Offshore - Oil Production Only - Offshore - Oil and Gas Production - Offshore - Pipelines - Offshore - Ready Stacked - Offshore - Unknown - Offshore - Waiting on Location - Offshore - Workover - Religion and Non-Profit - Churches - Religion and Non-Profit - Religion and Non-Profit - Residential - Apartments/Condominiums - Residential - Construction/Erection Risks - Residential - Damageable Land - Residential - General Residential - Residential - Group Institutional Housing - 'Residential - Permanent Dwelling: Multi-Family' - 'Residential - Permanent Dwelling: Single-Family' - Residential - Temporary Lodging - Residential - Terraced Housing - Restaurants - Restaurants - Transportation - Air - Transportation - Aircraft Hangars - Transportation - Aircraft at Ramps or Boarding Gates - Transportation - Highway - Transportation - Railroad - Transportation - Sea and Inland Waterways - Unknown - Utilities - Electrical Utilities - Utilities - Natural Gas - Utilities - Sanitary Sewer - Utilities - Telephone and Telegraph - Utilities - Water Utilities - null type: string x-spec-enum-id: 9b5d4f804759cae7 nullable: true description: Occupancy classification using Ping's taxonomy. occupancy__type_desc: type: string nullable: true description: Occupancy type description. postal_code: type: string nullable: true description: ZIP or postal code. site_name: type: string nullable: true description: Site or location name. sources: type: array items: type: string enum: - PG - PH - LB description: >- Specify any desired third-party data sources to include for this location. state: type: string nullable: true description: >- State as supplied (full name or abbreviation). See also state_code and state_name for normalized forms. state_code: type: string nullable: true description: Two-letter U.S. state abbreviation (e.g. 'CA'). state_name: type: string nullable: true description: Full U.S. state name (e.g. 'California'). required: - id - item_id ````