Decision tables

Deterministic rule tables (lease classification, reverse charge): fetch or evaluate.

GET /v1/decision-tables

List the decision tables

The deterministic rule tables: VAT place of supply, lease classification, IFRS 16 exemptions, inventory cost formulas.

data lists full tables: typed inputs, outputs, ordered rules with their legal reference, and limitations. Fetch a table to run it yourself, or POST inputs to /{table_id}/evaluate to have the API run it. An unknown domain returns an empty list.

Parameters

Example request

curl "$DATAVNEXT_URL/v1/decision-tables" \
  -H "X-API-Key: $DATAVNEXT_KEY"

Responses

Example response (shape)

{
  "data": [
    {
      "published_at": "2026-09-21",
      "updated_at": "2026-09-21",
      "sources": [
        null
      ],
      "id": "string",
      "name": "string",
      "description": "string",
      "domain": "string",
      "hit_policy": "first",
      "inputs": [
        null
      ],
      "outputs": [
        null
      ],
      "rules": [
        null
      ],
      "limitations": [
        "string"
      ]
    }
  ],
  "meta": {
    "dataset_version": "string",
    "as_of": "2026-09-21",
    "known_at": "2026-09-21",
    "sources": [
      {
        "authority": null,
        "url": null,
        "reference": null,
        "verified_at": null,
        "kind": null
      }
    ],
    "notes": [
      "string"
    ]
  }
}

GET /v1/decision-tables/{table_id}

Get a decision table

One decision table: inputs with their types and allowed values, outputs, and the ordered rules.

Rules are matched in order. The hit policy first stops at the first matching rule, collect returns every matching rule. A rule's when maps an input to a literal or to an operator map (in, not_in, ne, gt, gte, lt, lte); an input that is not listed matches anything. 404 for an unknown table id.

Parameters

Example request

curl "$DATAVNEXT_URL/v1/decision-tables/us_gaap.asc842.lessee_lease_classification" \
  -H "X-API-Key: $DATAVNEXT_KEY"

Responses

Example response (shape)

{
  "data": {
    "published_at": "2026-09-21",
    "updated_at": "2026-09-21",
    "sources": [
      {
        "authority": null,
        "url": null,
        "reference": null,
        "verified_at": null,
        "kind": null
      }
    ],
    "id": "string",
    "name": "string",
    "description": "string",
    "domain": "string",
    "hit_policy": "first",
    "inputs": [
      {
        "name": null,
        "type": null,
        "description": null,
        "values": null,
        "required": null,
        "default": null
      }
    ],
    "outputs": [
      {
        "name": null,
        "description": null
      }
    ],
    "rules": [
      {
        "id": null,
        "when": null,
        "then": null,
        "reference": null,
        "note": null
      }
    ],
    "limitations": [
      "string"
    ]
  },
  "meta": {
    "dataset_version": "string",
    "as_of": "2026-09-21",
    "known_at": "2026-09-21",
    "sources": [
      {
        "authority": null,
        "url": null,
        "reference": null,
        "verified_at": null,
        "kind": null
      }
    ],
    "notes": [
      "string"
    ]
  }
}

POST /v1/decision-tables/{table_id}/evaluate

Evaluate a decision table

Run a decision table on the given inputs and return the matched rule.

data.matches lists the rules that matched, in table order: one with hit policy first, all with collect, none if no rule applies. Each match has the rule's outputs (for example the lease classification), its legal reference and a note. data.inputs echoes the inputs as they were interpreted, and meta.notes repeats the table's limitations. Refuses with 404 for an unknown table and with 422 for an unknown input name, a missing required input, or a value that does not fit the input's type or allowed values.

Parameters

Request body

application/json (required): object

Example request

curl -X POST "$DATAVNEXT_URL/v1/decision-tables/us_gaap.asc842.lessee_lease_classification/evaluate" \
  -H "X-API-Key: $DATAVNEXT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "transfers_ownership": false,
  "purchase_option_reasonably_certain": false,
  "lease_term_percent_of_economic_life": 80,
  "commences_near_end_of_economic_life": false,
  "pv_payments_percent_of_fair_value": 70,
  "specialized_no_alternative_use": false
}'

Responses

Example response (shape)

{
  "data": {
    "table_id": "us_gaap.asc842.lessee_lease_classification",
    "hit_policy": "first",
    "inputs": {
      "transfers_ownership": false,
      "purchase_option_reasonably_certain": false,
      "lease_term_percent_of_economic_life": "80",
      "commences_near_end_of_economic_life": false,
      "pv_payments_percent_of_fair_value": "70",
      "specialized_no_alternative_use": false
    },
    "matches": [
      {
        "rule_id": "major_part_of_economic_life",
        "outputs": {
          "classification": "finance",
          "criterion": "lease_term"
        },
        "reference": "ASC 842-10-25-2(c), 842-10-55-2(a)-(b)"
      }
    ]
  },
  "meta": {
    "dataset_version": "3f2a9c1b7d4e",
    "sources": [
      {
        "authority": "FASB",
        "url": "https://asc.fasb.org/842/showallinonepage",
        "reference": "ASC 842-10-25-2",
        "verified_at": "2026-09-29",
        "kind": "official"
      }
    ],
    "notes": [
      "Short-term lease election (ASC 842-20-25-2) is not evaluated.",
      "Paraphrased criteria; consult the Codification for the authoritative text."
    ]
  }
}

Schemas

DecisionInput

DecisionOutput

DecisionTable

Envelope_DecisionTable_

Envelope_Evaluation_

Envelope_list_DecisionTable__

Evaluation

RuleMatch