Moody's RMS Location Intelligence API

Address geocoding and per-location peril and hazard risk lookups used to enrich exposure before modeling. The harvested OpenAPI 3.0.1 definition carries 366 paths under three declared tags — Geocoding, Composite, and Risk Lookups — returning geocode resolution (including a code mapped to the ACORD standard resolution scale), hazard scores, and peril-specific risk attributes by location.

OpenAPI Specification

moodys-rms-location-intelligence-openapi.yaml Raw ↑
openapi: 3.0.1
info:
  title: Location Intelligence API
  version: 2022.09.c
  description: >-
    Use LI API data to access RMS model insights in a flexible, scalable, and
    programmable way. The suite of layers includes exposure enhancement,
    geocoding, hazard, risk scoring, and loss costs to provide information for
    key decisions in the underwriting workflow, including screening, selection,
    and pricing.
x-readme:
  explorer-enabled: false
  samples-languages:
    - curl
    - java
    - csharp
    - node
    - python
  proxy-enabled: true
  samples-enabled: true
servers:
  - url: https://{host}/li
    description: Location Intelligence
    variables:
      host:
        enum:
          - api-euw1.rms.com
          - api-use1.rms.com
        default: api-euw1.rms.com
        description: >-
          Data center that hosts the tenant instance: api-euw1.rms.com or
          api-use1.rms.com.
externalDocs:
  description: Find out more about RMS
  url: https://www.rms.com/programs/location-intelligence-api/
tags:
  - name: Geocoding
    description: Geocodes an address
  - name: Composite
    description: >-
      Returns multiple layers for an address, including chaining the output of
      one layer into the input for another
  - name: Risk Lookups
    description: >-
      Returns one exposure, hazard, risk score, or loss cost layer for an
      address
paths:
  /{layer}/{version}:
    post:
      tags:
        - Risk Lookups
      summary: Generic Lookup
      operationId: genericLookup
      parameters:
        - name: layer
          in: path
          description: Layer name
          example: us_fema_firm
          required: true
          schema:
            type: string
        - name: version
          in: path
          description: Layer version
          example: latest
          required: true
          schema:
            type: string
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GenericInput'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '404':
          $ref: '#/components/responses/404Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ac_eq_hazard/18.0:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Central America Earthquake Hazard 18.0
      description: ''
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/SvAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ac_eq_hazard/18.1:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Central America Earthquake Hazard 18.1
      description: ''
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/SvAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ac_eq_hazard/latest:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Central America Earthquake Hazard Latest
      description: ''
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/SvAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ah_eq_hazard/18.0:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: South American Earthquake Hazard 18.0
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/BrAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ah_eq_hazard/18.1:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: South American Earthquake Hazard 18.1
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/BrAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ah_eq_hazard/latest:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: South American Earthquake Hazard Latest
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/BrAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ap_eq_hazard/18.0:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Southeast Asia Earthquake Hazard 18.0
      description: ''
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/VnAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ap_eq_hazard/18.1:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Southeast Asia Earthquake Hazard 18.1
      description: ''
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/VnAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /ap_eq_hazard/latest:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Southeast Asia Earthquake Hazard Lastest
      description: ''
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/VnAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_hazard/18.0:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Australia Earthquake Hazard 18.0
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_hazard/18.1:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Australia Earthquake Hazard 18.1
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_hazard/latest:
    post:
      tags:
        - Earthquake Hazard Lookup
      summary: Australia Earthquake Hazard Latest
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarthquakeHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_loss_cost/18.1:
    post:
      tags:
        - Risk Lookups
      summary: Australia Earthquake Loss Cost 18.1
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/LocationInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                        - postalCodeGeoId
                      example:
                        $ref: '#/components/examples/AuAddress/value'
                    characteristics:
                      example:
                        $ref: '#/components/examples/CharacteristicsBasic/value'
                    coverageValues:
                      $ref: '#/components/schemas/CoverageValuesInput'
                layerOptions:
                  type: object
                  properties:
                    deductibleType:
                      type: integer
                      description: >
                        Deductible type: * `1` - Building * `2` - Contents * `3`
                        - BI * `4` - Combined * `5` - Site
                      minimum: 1
                      maximum: 5
                      example: 1
                    deductibleAmount:
                      type: number
                      format: double
                      description: Deductible amount in %, or dollar amount
                      example: 0.1
                    deductibleAmount2:
                      type: number
                      format: double
                      description: Deductible 2 amount in %, or dollar amount
                      example: 0.05
                    deductibleAmount3:
                      type: number
                      format: double
                      description: Deductible 3 amount in %, or dollar amount
                      example: 0.02
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuGrLossCostOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_loss_cost/latest:
    post:
      tags:
        - Risk Lookups
      summary: Australia Earthquake Loss Cost Latest
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/LocationInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                        - postalCodeGeoId
                      example:
                        $ref: '#/components/examples/AuAddress/value'
                    characteristics:
                      example:
                        $ref: '#/components/examples/CharacteristicsBasic/value'
                    coverageValues:
                      $ref: '#/components/schemas/CoverageValuesInput'
                layerOptions:
                  type: object
                  properties:
                    deductibleType:
                      type: integer
                      description: >
                        Deductible type: * `1` - Building * `2` - Contents * `3`
                        - BI * `4` - Combined * `5` - Site
                      minimum: 1
                      maximum: 5
                      example: 1
                    deductibleAmount:
                      type: number
                      format: double
                      description: Deductible amount in %, or dollar amount
                      example: 0.1
                    deductibleAmount2:
                      type: number
                      format: double
                      description: Deductible 2 amount in %, or dollar amount
                      example: 0.05
                    deductibleAmount3:
                      type: number
                      format: double
                      description: Deductible 3 amount in %, or dollar amount
                      example: 0.02
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GuGrLossCostOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_risk_score/18.1:
    post:
      tags:
        - Risk Lookups
      summary: Australia Earthquake Risk Score 18.1
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/LocationInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
                    characteristics:
                      example:
                        $ref: '#/components/examples/CharacteristicsBasic/value'
                    coverageValues:
                      type: object
                      example: {}
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuRiskScoreOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_eq_risk_score/latest:
    post:
      tags:
        - Risk Lookups
      summary: Australia Earthquake Risk Score Latest
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/LocationInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
                    characteristics:
                      example:
                        $ref: '#/components/examples/CharacteristicsBasic/value'
                    coverageValues:
                      type: object
                      example: {}
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuRiskScoreOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_ws_hazard/18.0:
    post:
      tags:
        - Windstorm Hazard Lookup
      summary: Australia Windstorm Hazard 18.0
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HurricaneHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_ws_hazard/18.1:
    post:
      tags:
        - Windstorm Hazard Lookup
      summary: Australia Windstorm Hazard 18.1
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HurricaneHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_ws_hazard/latest:
    post:
      tags:
        - Windstorm Hazard Lookup
      summary: Australia Windstorm Hazard Latest
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/AddressInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitude
                        - countryRmsCode
                        - rmsGeoModelResolutionCode
                      example:
                        $ref: '#/components/examples/AuAddress/value'
        required: true
      responses:
        '200':
          description: Everything worked as expected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HurricaneHazardOutput'
        '400':
          $ref: '#/components/responses/400Response'
        '401':
          $ref: '#/components/responses/401Response'
        '500':
          $ref: '#/components/responses/500Response'
  /au_ws_loss_cost/18.1:
    post:
      tags:
        - Risk Lookups
      summary: Australia Cyclone Loss Cost 18.1
      requestBody:
        description: Request
        content:
          application/json:
            schema:
              type: object
              required:
                - location
              properties:
                location:
                  type: object
                  allOf:
                    - $ref: '#/components/schemas/LocationInput'
                    - type: object
                  properties:
                    address:
                      type: object
                      required:
                        - latitude
                        - longitud

# --- truncated at 32 KB (788 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/moodys-rms/refs/heads/main/openapi/moodys-rms-location-intelligence-openapi.yaml