One Concern

One Concern Location API

The Location API from One Concern — 5 operation(s) for location.

GitHub OpenAPI
Business capability
Asset Risk Management BC-4920.60

Operations 5

POST /v1/location/business-interruption/return-period Business Interruption Risk Scores By Return Period #
POST /v1/location/business-interruption/average-annual Business Interruption Risk Scores By Average Annual Downtime #
POST /v1/location/business-interruption/planning-horizon Bi Risk Score By Planning Horizon #
POST /v1/location/property-damage/return-period Property Damage Ratio By Return Period #
POST /v1/location/property-damage/average-annual Property Damage Ratio By Average Annual Downtime #

Documentation

📖
Documentation
https://developer.oneconcern.com/overview
📖
APIReference
https://developer.oneconcern.com/api-spec
📖
GettingStarted
https://developer.oneconcern.com/overview
📖
Authentication
https://artifacts.apis.io/one-concern/authentication/one-concern-authentication.yml
📖
RateLimits
https://artifacts.apis.io/one-concern/rate-limits/one-concern-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/one-concern/openapi/one-concern-location-api-openapi.yml

Other Resources

🔗
Conventions
https://artifacts.apis.io/one-concern/conventions/one-concern-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/one-concern/errors/one-concern-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/one-concern/data-model/one-concern-data-model.yml
🔗
Lifecycle
https://artifacts.apis.io/one-concern/lifecycle/one-concern-lifecycle.yml
🔗
Conformance
https://artifacts.apis.io/one-concern/conformance/one-concern-conformance.yml
🔗
Plans
https://artifacts.apis.io/one-concern/plans/one-concern-plans-pricing.yml
🔗
MCPCandidate
https://artifacts.apis.io/one-concern/mcp/one-concern-mcp.yml
🔗
APIsJSON
https://artifacts.apis.io/one-concern/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/one-concern:one-concern-location-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

one-concern-location-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Domino AI Location API
  description: Domino AI API
  version: v1.31.2
host: dna-api.dev.onec.co
basePath: /v1
schemes:
- https
tags:
- name: Location
paths:
  /v1/location/business-interruption/return-period:
    post:
      summary: Business Interruption Risk Scores By Return Period
      description: '### Business Interruption Risk Scores By Return Period


        returns business interruption risk scores for location entries

        based on the return period'
      operationId: Business_Interruption_Risk_Scores_By_Return_Period_v1_location_business_interruption_return_period_post
      parameters:
      - required: true
        schema:
          type: string
          title: Client-Id
          examples:
          - test-client-id
        name: client-id
        in: header
      - required: false
        schema:
          type: string
          title: Transaction-Id
          examples:
          - test-transaction-id
        name: transaction-id
        in: header
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BIRiskScoreRequestRP'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BIRiskScoreResponse'
        '204':
          description: No data available for given latitude/longitude
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Location
  /v1/location/business-interruption/average-annual:
    post:
      summary: Business Interruption Risk Scores By Average Annual Downtime
      description: '### Business Interruption Risk Scores By Average Annual


        returns business interruption risk scores for location entries

        based on the average annual downtime'
      operationId: Business_Interruption_Risk_Scores_By_Average_Annual_Downtime_v1_location_business_interruption_average_annual_post
      parameters:
      - required: true
        schema:
          type: string
          title: Client-Id
          examples:
          - test-client-id
        name: client-id
        in: header
      - required: false
        schema:
          type: string
          title: Transaction-Id
          examples:
          - test-transaction-id
        name: transaction-id
        in: header
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BIRiskScoreRequestAA'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BIRiskScoreResponse'
        '204':
          description: No data available for given latitude/longitude
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Location
  /v1/location/business-interruption/planning-horizon:
    post:
      summary: Bi Risk Score By Planning Horizon
      description: '### BI Risk by Planning Horizon


        returns bi risk score for location entries based on planning horizon years'
      operationId: BI_Risk_Score_By_Planning_Horizon_v1_location_business_interruption_planning_horizon_post
      parameters:
      - required: true
        schema:
          type: string
          title: Client-Id
          examples:
          - test-client-id
        name: client-id
        in: header
      - required: false
        schema:
          type: string
          title: Transaction-Id
          examples:
          - test-transaction-id
        name: transaction-id
        in: header
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BIRiskScoreRequestPH'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BIRiskScoreResponse'
        '204':
          description: No data available for given latitude/longitude
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Location
  /v1/location/property-damage/return-period:
    post:
      summary: Property Damage Ratio By Return Period
      description: '### Property Damage By Return Period


        returns property damage for location entries based on the return period'
      operationId: Property_Damage_Ratio_By_Return_Period_v1_location_property_damage_return_period_post
      parameters:
      - required: true
        schema:
          type: string
          title: Client-Id
          examples:
          - test-client-id
        name: client-id
        in: header
      - required: false
        schema:
          type: string
          title: Transaction-Id
          examples:
          - test-transaction-id
        name: transaction-id
        in: header
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PropertyDamageRequestRP'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertyDamageResponse'
        '204':
          description: No data available for given latitude/longitude
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Location
  /v1/location/property-damage/average-annual:
    post:
      summary: Property Damage Ratio By Average Annual Downtime
      description: '### Property Damage By Average Annual Downtime


        returns property damage for location entries based on the average annual downtime'
      operationId: Property_Damage_Ratio_By_Average_Annual_Downtime_v1_location_property_damage_average_annual_post
      parameters:
      - required: true
        schema:
          type: string
          title: Client-Id
          examples:
          - test-client-id
        name: client-id
        in: header
      - required: false
        schema:
          type: string
          title: Transaction-Id
          examples:
          - test-transaction-id
        name: transaction-id
        in: header
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PropertyDamageRequestAA'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PropertyDamageResponse'
        '204':
          description: No data available for given latitude/longitude
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Location
components:
  schemas:
    BIRiskScoreRequestAA:
      properties:
        interruption_type:
          allOf:
          - $ref: '#/components/schemas/BusinessInterruptionType'
          title: interruption_type
          description: Interruption type, also known as the dependency or lifeline, refers to the component of infrastructure that is essential to recovery. Please note that different countries and peril combinations may support different dependencies.
        latitude:
          type: number
          maximum: 90.0
          minimum: -90.0
          title: latitude
          description: The latitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - 33.814437
        longitude:
          type: number
          maximum: 180.0
          minimum: -180.0
          title: longitude
          description: The longitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - -118.051187
        max_distance_m:
          type: number
          maximum: 500.0
          exclusiveMinimum: 1.0
          title: max_distance_m
          description: The maximum distance from the provided (lat,long) pair to use when retrieving built object downtime statistics, bi risk scores or other metrics
          default: 500
          examples:
          - 100
          - 250
          - 500
          units: meters
        climate_change:
          allOf:
          - $ref: '#/components/schemas/ClimateChange'
          title: climate_change
          description: The climate change scenario (by Average Annual Downtime)
        peril:
          allOf:
          - $ref: '#/components/schemas/PerilAA'
          title: peril
          description: The cause of loss or damage
          examples:
          - flood
      additionalProperties: false
      type: object
      required:
      - interruption_type
      - latitude
      - longitude
      - climate_change
      - peril
      title: BIRiskScoreRequestAA
      description: BI Risk Score Request class (by Average Annual Downtime)
    PerilRP:
      type: string
      enum:
      - flood
      - wind
      - seismic
      title: PerilRP
      description: Peril for Return Period. Peril is the cause of downtime.
    BIRiskScoreRequestRP:
      properties:
        interruption_type:
          allOf:
          - $ref: '#/components/schemas/BusinessInterruptionType'
          title: interruption_type
          description: Interruption type, also known as the dependency or lifeline, refers to the component of infrastructure that is essential to recovery. Please note that different countries and peril combinations may support different dependencies.
        latitude:
          type: number
          maximum: 90.0
          minimum: -90.0
          title: latitude
          description: The latitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - 33.814437
        longitude:
          type: number
          maximum: 180.0
          minimum: -180.0
          title: longitude
          description: The longitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - -118.051187
        max_distance_m:
          type: number
          maximum: 500.0
          exclusiveMinimum: 1.0
          title: max_distance_m
          description: The maximum distance from the provided (lat,long) pair to use when retrieving built object downtime statistics, bi risk scores or other metrics
          default: 500
          examples:
          - 100
          - 250
          - 500
          units: meters
        climate_change:
          allOf:
          - $ref: '#/components/schemas/ClimateChange'
          title: climate_change
          description: The climate change scenario (by Return Period)
        return_period_yrs:
          allOf:
          - $ref: '#/components/schemas/ReturnPeriod'
          title: return_period_yrs
          description: The return period used to calculate statistics and metrics in years
          units: years
        peril:
          allOf:
          - $ref: '#/components/schemas/PerilRP'
          title: peril
          description: The cause of loss or damage
          examples:
          - flood
      additionalProperties: false
      type: object
      required:
      - interruption_type
      - latitude
      - longitude
      - climate_change
      - return_period_yrs
      - peril
      title: BIRiskScoreRequestRP
      description: BI Risk Score Request class (by Return Period) for V1 endpoints
    PropertyDamageRequestRP:
      properties:
        latitude:
          type: number
          maximum: 90.0
          minimum: -90.0
          title: latitude
          description: The latitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - 33.814437
        longitude:
          type: number
          maximum: 180.0
          minimum: -180.0
          title: longitude
          description: The longitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - -118.051187
        max_distance_m:
          type: number
          maximum: 500.0
          exclusiveMinimum: 1.0
          title: max_distance_m
          description: The maximum distance from the provided (lat,long) pair to use when retrieving built object downtime statistics, bi risk scores or other metrics
          default: 500
          examples:
          - 100
          - 250
          - 500
          units: meters
        peril:
          allOf:
          - $ref: '#/components/schemas/PerilRP'
          title: peril
          description: The cause of loss or damage
          examples:
          - flood
        climate_change:
          allOf:
          - $ref: '#/components/schemas/ClimateChange'
          title: climate_change
          description: The climate change scenario (by Return Period)
        return_period_yrs:
          allOf:
          - $ref: '#/components/schemas/ReturnPeriod'
          title: return_period_yrs
          description: The return period used to calculate statistics and metrics in years
          units: years
      additionalProperties: false
      type: object
      required:
      - latitude
      - longitude
      - peril
      - climate_change
      - return_period_yrs
      title: PropertyDamageRequestRP
      description: Property Damage Request (Return Period) for V1 endpoints
    PerilAA:
      type: string
      enum:
      - flood
      - integrated
      - wind
      - seismic
      title: PerilAA
      description: Peril for Average Annual. Peril is the cause of downtime.
    ReturnPeriod:
      type: integer
      enum:
      - 50
      - 100
      - 250
      - 500
      - 1000
      title: ReturnPeriod
      description: "Time period of interest in years.\n\nNote:\n    - average annual defines time period as one year\n    - these are the set of return period available for the V1 endpoints"
    BusinessInterruptionType:
      type: string
      enum:
      - integrated
      - utility
      - ingress_egress
      - community
      - repair_time
      - ports
      - airports
      - bridges
      - highways
      title: BusinessInterruptionType
      description: 'Interruption type, also known as the dependency or lifeline, refers to the component of infrastructure that is essential to recovery.

        Please note that different countries and peril combinations may support different dependencies.'
    PropertyDamageRequestAA:
      properties:
        latitude:
          type: number
          maximum: 90.0
          minimum: -90.0
          title: latitude
          description: The latitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - 33.814437
        longitude:
          type: number
          maximum: 180.0
          minimum: -180.0
          title: longitude
          description: The longitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - -118.051187
        max_distance_m:
          type: number
          maximum: 500.0
          exclusiveMinimum: 1.0
          title: max_distance_m
          description: The maximum distance from the provided (lat,long) pair to use when retrieving built object downtime statistics, bi risk scores or other metrics
          default: 500
          examples:
          - 100
          - 250
          - 500
          units: meters
        peril:
          allOf:
          - $ref: '#/components/schemas/PerilAA'
          title: peril
          description: The cause of loss or damage
          examples:
          - flood
        climate_change:
          allOf:
          - $ref: '#/components/schemas/ClimateChange'
          title: climate_change
          description: The climate change scenario (by Average Annual Downtime)
      additionalProperties: false
      type: object
      required:
      - latitude
      - longitude
      - peril
      - climate_change
      title: PropertyDamageRequestAA
      description: Property Damage Request (Average Annual)
    BIRiskScoreRequestPH:
      properties:
        interruption_type:
          allOf:
          - $ref: '#/components/schemas/BusinessInterruptionType'
          title: interruption_type
          description: Interruption type, also known as the dependency or lifeline, refers to the component of infrastructure that is essential to recovery. Please note that different countries and peril combinations may support different dependencies.
        latitude:
          type: number
          maximum: 90.0
          minimum: -90.0
          title: latitude
          description: The latitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - 33.814437
        longitude:
          type: number
          maximum: 180.0
          minimum: -180.0
          title: longitude
          description: The longitude used as part of the (lat,long) pair that is provided in requests/responses
          examples:
          - -118.051187
        max_distance_m:
          type: number
          maximum: 500.0
          exclusiveMinimum: 1.0
          title: max_distance_m
          description: The maximum distance from the provided (lat,long) pair to use when retrieving built object downtime statistics, bi risk scores or other metrics
          default: 500
          examples:
          - 100
          - 250
          - 500
          units: meters
        climate_change:
          allOf:
          - $ref: '#/components/schemas/ClimateChange'
          title: climate_change
          description: The climate change scenario (by Average Annual Downtime)
        planning_horizon_yrs:
          allOf:
          - $ref: '#/components/schemas/PlanningHorizon'
          title: planning_horizon
          description: The planning_horizon used to calculate statistics and metrics
          units: years
        peril:
          allOf:
          - $ref: '#/components/schemas/PerilAA'
          title: peril
          description: The cause of loss or damage
          examples:
          - flood
      additionalProperties: false
      type: object
      required:
      - interruption_type
      - latitude
      - longitude
      - climate_change
      - planning_horizon_yrs
      - peril
      title: BIRiskScoreRequestPH
      description: BI Risk Score Request class (by Planning Horizon)
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PropertyDamageResponse:
      properties:
        id:
          type: string
          title: id
          description: ID (uuid) of the location
        damage_ratio_avg:
          type: number
          title: damage_ratio_avg
          description: The direct structural impact of a hazard on a particular location of interest for risk analysis
          examples:
          - '0.1'
        damage_ratio_stdev:
          type: number
          title: damage_ratio_stdev
          description: The standard deviation of the property damage for a particular location of interest for risk analysis
          examples:
          - '0.05'
      type: object
      required:
      - id
      - damage_ratio_avg
      - damage_ratio_stdev
      title: PropertyDamageResponse
      description: Response class that holds the retrieved property damage for a location
    PlanningHorizon:
      type: integer
      enum:
      - 1
      - 5
      - 10
      - 20
      - 30
      title: PlanningHorizon
      description: Planning horizon time period type enums
    ClimateChange:
      type: string
      enum:
      - ccbaseline
      - cc2050_45
      title: ClimateChange
      description: Average annual downtime climate change request enums
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    BIRiskScoreResponse:
      properties:
        id:
          type: string
          title: id
          description: ID (uuid) of the location
        downtime_avg_days:
          type: number
          title: downtime_avg_days
          description: The average downtime for a particular location of interest for risk analysis in days
          examples:
          - 1.5
          units: days
        downtime_stdev_days:
          type: number
          title: downtime_stdev_days
          description: The standard deviation of the downtime for a particular location of interest for risk analysis
          examples:
          - 1.5
          units: days
        score:
          type: string
          title: score
          description: The risk score label applied to a particular location of interest for risk analysis
          examples:
          - very_low
          - low
          - moderate
          - significant
          - high
          - very_high
          - extreme
      type: object
      required:
      - id
      - downtime_avg_days
      - downtime_stdev_days
      - score
      title: BIRiskScoreResponse
      description: Response class that holds the retrieved bi risk score for a location
x-provenance:
  method: harvested
  publisher: One Concern
  source: https://developer.oneconcern.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)