---
title: "POST /api/rpc/queryValuesAgainstInflation"
method: POST
path: "/api/rpc/queryValuesAgainstInflation"
tags: ["insurance"]
---

# POST /api/rpc/queryValuesAgainstInflation

`POST /api/rpc/queryValuesAgainstInflation`

## Request

- Base URL: `https://21risk.com`
- URL: `https://21risk.com/api/rpc/queryValuesAgainstInflation`
- Auth: OAuth 2 (client credentials, token URL `/api/v1/oauth/token`)

Check whether a period's insured values kept up with inflation since the previous period, the way Insurance Analytics → Inflation shows it. Each site's value is held to prices in its own country from public statistics: buildings and lease improvements to construction prices (consumer prices where a country has none), every other value to consumer prices. Inflation is measured over as many months as the period is long, up to its inception date (the newest published months for a period that starts later), within one price series; figures more than a year old are still used and marked outOfDate. Changes leave exchange rates out, and a site reporting in another currency than its country's is held to local inflation converted to that currency. Returns the inflation per country with its sources, per-value summaries for the portfolio and per country (never summed across values), and every site's values against inflation. By default it returns the inflation per country and the summaries; add sites, history or sources to include for more, and use value and countryCode to narrow the answer. The figures are an indication from public statistics, not a valuation.

## Request body

- object
  - `tenant` unknown, required
  - `period` string, required: Name of the Insurance period, for example "2027".
  - `value` string: Compare only this value: a built-in key such as buildings, machineryAndEquipment, stockAndSupplies or businessInterruption, or the id of one of the period's own value columns (see queryInsurancePeriod's valueColumns). Leave it out for every value the period collects.
  - `countryCode` string: Only the sites in this country, as an ISO 3166 alpha-2 code such as DE.
  - `include` string[]: What to add to the inflation per country and the per-value summaries, which are always returned: sites lists every site and its values against inflation; history each country's annual change in prices per quarter for the last eight years; sources every price index held for each country. Leave it out for the smallest answer.

## Response `200`

Successful response

- object
  - `period` object, required
    - `name` string, required
    - `inceptionDate` string, date-time, required
  - `previousPeriod` object, nullable, required: The period compared with, or null for the first period.
    - `name` string, required
    - `inceptionDate` string, date-time, required
  - `baseCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAU' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWL', required
  - `comparison` object, nullable, required: Null for the first period, which has nothing to compare with.
    - `months` integer, required: How many months inflation is measured over.
    - `values` object[], required: The values sites report in either period, in the Values table’s order.
      - `key` string, required
      - `title` string, required
      - `inTiv` boolean, required
      - `kind` 'consumer' | 'construction', required: The index the value is compared with where a country has it.
    - `countries` object[], required: The countries of the sites with values, with the inflation measured there.
      - `countryCode` string, required
      - `countryName` string, required
      - `countryEmoji` string, required
      - `localCurrency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAU' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWL', nullable, required
      - `change` object, required
        - `consumer` object, nullable, required: Null when the country has no index of this kind.
          - `seriesId` string, required
          - `precision` 'month' | 'quarter' | 'year', required
          - `from` string, required: First day of the period the change is measured from.
          - `to` string, required: First day of the period the change is measured to.
          - `toEnd` string, required: Last day of that period.
          - `change` number, required: The price change over the window, as a fraction (0.031 = +3.1%).
          - `label` string, required: The series, for example "DST CPI".
          - `sourceName` string, required: The publisher.
          - `outOfDate` boolean, required: True when the newest figures are more than a year old: still used, but should be read with care.
        - `construction` object, nullable, required: Null when the country has no index of this kind.
          - `seriesId` string, required
          - `precision` 'month' | 'quarter' | 'year', required
          - `from` string, required: First day of the period the change is measured from.
          - `to` string, required: First day of the period the change is measured to.
          - `toEnd` string, required: Last day of that period.
          - `change` number, required: The price change over the window, as a fraction (0.031 = +3.1%).
          - `label` string, required: The series, for example "DST CPI".
          - `sourceName` string, required: The publisher.
          - `outOfDate` boolean, required: True when the newest figures are more than a year old: still used, but should be read with care.
      - `history` object, required: Annual change per period; empty unless include has history.
        - `consumer` object[], required
          - `periodStart` string, required
          - `precision` 'month' | 'quarter' | 'year', required
          - `annualChange` number, required
        - `construction` object[], required
          - `periodStart` string, required
          - `precision` 'month' | 'quarter' | 'year', required
          - `annualChange` number, required
      - `sources` object[], required: Every price index held for the country; empty unless include has sources.
        - `seriesId` string, required
        - `kind` 'consumer' | 'construction', required: consumer: consumer prices; construction: construction prices.
        - `label` string, required
        - `title` string, required
        - `sourceName` string, required
        - `datasetUrl` string, required
        - `frequency` 'month' | 'quarter' | 'year', required
        - `basePeriod` string, nullable, required
        - `latest` object, nullable, required
          - `periodStart` string, required
          - `precision` 'month' | 'quarter' | 'year', required
        - `retrievedAt` string, date-time, nullable, required
    - `summaries` object[], required: Per value, never summed across values: the portfolio and every country.
      - `key` string, required
      - `portfolio` object, required
        - `previous` number, required: Last period's values, in base currency at last period's rates.
        - `current` number, required: This period's values, in base currency at last period's rates, so exchange rates add nothing.
        - `expected` number, required: What the values would be had each risen with its own country’s inflation.
        - `gap` number, required: current − expected: negative when the values fall short of inflation.
        - `change` number, nullable, required: The change in the values, as a fraction.
        - `inflation` number, nullable, required: The inflation the values are held to, weighted by last period’s values, as a fraction.
        - `status` 'below' | 'inLine' | 'above', nullable, required
        - `counts` object, required: Sites per status. New and removed values and sites without a price index are not compared.
          - `below` integer, required
          - `inLine` integer, required
          - `above` integer, required
          - `new` integer, required
          - `removed` integer, required
          - `noInflation` integer, required
      - `countries` object[], required
        - `countryCode` string, required: Empty for sites without a country.
        - `countryName` string, required
        - `countryEmoji` string, required
        - `reported` number, required: The value this period, at its own rates, as the Values table shows it.
        - `tiv` number, required: The country's total insured value this period.
        - `summary` object, required
          - `previous` number, required: Last period's values, in base currency at last period's rates.
          - `current` number, required: This period's values, in base currency at last period's rates, so exchange rates add nothing.
          - `expected` number, required: What the values would be had each risen with its own country’s inflation.
          - `gap` number, required: current − expected: negative when the values fall short of inflation.
          - `change` number, nullable, required: The change in the values, as a fraction.
          - `inflation` number, nullable, required: The inflation the values are held to, weighted by last period’s values, as a fraction.
          - `status` 'below' | 'inLine' | 'above', nullable, required
          - `counts` object, required: Sites per status. New and removed values and sites without a price index are not compared.
            - `below` integer, required
            - `inLine` integer, required
            - `above` integer, required
            - `new` integer, required
            - `removed` integer, required
            - `noInflation` integer, required
    - `sites` object[], required: The sites with values; empty unless include has sites.
      - `_id` string, required
      - `name` string, required
      - `parents` object[], required
        - `_id` string, required
        - `name` string, required
      - `countryCode` string, nullable, required
      - `tiv` number, required
      - `valueStatus` string, required
      - `valuesReviewedCount` integer, required
      - `valuesTotalCount` integer, required
    - `comparisons` object[], required: Every site’s value against inflation; empty unless include has sites.
      - `siteId` string, required
      - `key` string, required
      - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAU' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWL', required: The currency the site reports the value in.
      - `previous` number, required
      - `current` number, required
      - `reported` number, required
      - `change` number, nullable, required
      - `kind` 'consumer' | 'construction', required: consumer: consumer prices; construction: construction prices.
      - `inflation` number, nullable, required: The price change the value is held to, in the currency it is reported in.
      - `converted` boolean, required: True when the site reports in another currency than its country's, so local inflation is converted at the two periods' rates.
      - `status` 'below' | 'inLine' | 'above' | 'new' | 'removed' | 'noInflation', required

---

[API](https://skmtc.dev/21risk/apis/21risk-api.md) · [All operations](https://skmtc.dev/21risk/apis/21risk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/21risk/apis/21risk-api/revisions/b8a9eff9eb27?raw)