---
title: "GIR Data-Point Completeness Analyzer"
method: POST
path: "/v1/tools/analyze_gir_data_point_completeness"
tags: ["GloBE", "Pillar Two", "GIR", "data points", "gap analysis", "OECD", "minimum tax", "readiness"]
---

# GIR Data-Point Completeness Analyzer

`POST /v1/tools/analyze_gir_data_point_completeness`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/analyze_gir_data_point_completeness`
- Auth: none declared

Declare the GloBE Information Return data points your own systems can populate, together with the facts that switch conditional points on, and get back a per-point map of populated, partial and missing entries plus a coverage figure over the declared inventory. The data-point structure is taken from the OECD GloBE Information Return (January 2025), Annex A1, at the granularity of that publication's own numbered sub-tables. Readiness mapping only: it does not compose a return, does not render GIR XML, and never states that a return may be submitted.

**Tool URL:** https://ainumbers.co/tools/626-gir-data-point-completeness-analyzer.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `declared_inventory` unknown[], required: [{id, status}] with status populated, partial or missing
    - unknown
  - `declared_facts` object, required: Boolean facts that switch conditional data points on
  - `gir_schema_version` string: Declared GIR structure identifier
  - `reporting_fiscal_year_label` string: Optional free-text label

## Response `200`

Successful tool execution result

- object
  - `gir_structure_declared` string
  - `total_points_in_structure` integer
  - `applicable_points` integer
  - `populated` integer
  - `partial` integer
  - `missing` integer
  - `not_applicable` integer
  - `conditional_points_applicable` integer
  - `coverage_over_declared_inventory_pct` number: Populated over applicable, as a percentage. A coverage count over the declared inventory, never a readiness verdict.
  - `unrecognised_references` unknown[]: Input references that matched no data point in the declared structure, reported rather than silently dropped.
    - unknown
  - `points` unknown[]: Per data point: reference, label, requirement (always or conditional), the named condition, whether the condition was declared, applicability, and declared status.
    - unknown

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)