---
title: "Grounding Packet — the named, free-tier grounding payload over the verified record: deterministic verified facts with provenance, corrections to common AI claims, and Ed25519-signed provenance. Fetch at the top of any agent/RAG workflow. ?format=grounding-metadata returns a GroundingMetadata-shaped projection (groundingChunks / groundingSupports) for Vertex-shaped pipelines. Free tier, rate-limited; zero LLM cost."
method: GET
path: "/entities/{entityId}/grounding-packet"
tags: ["Layer 0 — Discovery"]
---

# Grounding Packet — the named, free-tier grounding payload over the verified record: deterministic verified facts with provenance, corrections to common AI claims, and Ed25519-signed provenance. Fetch at the top of any agent/RAG workflow. ?format=grounding-metadata returns a GroundingMetadata-shaped projection (groundingChunks / groundingSupports) for Vertex-shaped pipelines. Free tier, rate-limited; zero LLM cost.

`GET /entities/{entityId}/grounding-packet`

## Request

- Base URL: `https://entidex.com/api/v1`
- URL: `https://entidex.com/api/v1/entities/{entityId}/grounding-packet`
- Auth: HTTP bearer

## Path parameters

- `entityId` string, required

## Query parameters

- `format` 'grounding-metadata'

## Response `200`

Grounding Packet (default) or the GroundingMetadata-shaped projection.

- union
  - GroundingPacket: Grounding Packet — the named, free-tier developer packaging of the Entity Knowledge Statement: one small, deterministic per-entity grounding payload (verified facts with provenance + corrections to common AI claims + Ed25519-signed provenance) fetched at the top of an agent/RAG workflow. Deterministic: the same underlying record always projects to an identical payload.
    - `packetVersion` string, required
    - `entity` object, required
      - `id` string, required: Canonical entx_xxxx id.
      - `slug` string, required
      - `canonicalName` string, required
      - `type` string, required
      - `description` string, nullable, required
      - `identifiers` object, required
        - `wikidataQid` string, nullable
        - `website` string, nullable
      - `sameAs` string[], required: Cross-referenced identity URLs, sorted.
    - `facts` GroundingPacketFact[], required: Verified facts, one per canonical field, sorted by field.
      - `field` string, required
      - `value` string, required
      - `source` string, required: Provenance label of the verified source (e.g. "Wikidata").
      - `confidence` integer, required
      - `asOf` string, date-time, nullable, required
    - `corrections` GroundingPacketCorrection[], required: Corrections to common AI claims, sorted by field.
      - `field` string, required
      - `commonAiClaim` string, nullable, required: What AI engines commonly claim (null for an ai_unaware gap).
      - `verifiedValue` string, nullable, required
      - `source` string, required
      - `status` 'contradiction' | 'ai_unaware', required
      - `asOf` string, date-time, nullable, required
    - `accuracy` object, required
      - `pct` integer, nullable
      - `matches` integer
      - `mismatches` integer
      - `evaluated` integer
    - `provenance` KnowledgeStatementProvenance, required
      - `issuer` string, required
      - `issuerId` string, required
      - `statementUrl` string, uri, required
      - `methodologyUrl` string, uri, required
      - `license` string, uri, required
      - `generatedAt` string, date-time, required
      - `note` string, required
      - `proof` object, nullable, required: JsonWebSignature2020 proof attached when a signing key is configured.
        - `type` string
        - `contentHash` string: SHA-256 hash of the canonicalised statement (proof field excluded).
        - `jws` string: Ed25519 JWS over the content hash.
        - `verificationMethod` string
    - `links` object, required: Sibling machine-readable surfaces over the same record.
      - `knowledgeMarkdown` string
      - `knowledgeJsonLd` string
      - `groundTruthApi` string
  - GroundingMetadataProjection: GroundingMetadata-shaped projection of the Grounding Packet (?format=grounding-metadata): groundingChunks / groundingSupports over a synthesized fact digest, mirroring Google Vertex grounding field names so Vertex-shaped pipelines consume the packet without adapter code.
    - `packetVersion` string, required
    - `entity` object, required
      - `id` string
      - `slug` string
      - `canonicalName` string
    - `text` string, required: The grounded fact digest the supports index into (one fact line per support).
    - `groundingChunks` object[], required
      - `web` object
        - `uri` string
        - `title` string
    - `groundingSupports` object[], required
      - `segment` object
        - `startIndex` integer
        - `endIndex` integer
        - `text` string
      - `groundingChunkIndices` integer[]
      - `confidenceScores` number[]
    - `provenance` KnowledgeStatementProvenance, required
      - `issuer` string, required
      - `issuerId` string, required
      - `statementUrl` string, uri, required
      - `methodologyUrl` string, uri, required
      - `license` string, uri, required
      - `generatedAt` string, date-time, required
      - `note` string, required
      - `proof` object, nullable, required: JsonWebSignature2020 proof attached when a signing key is configured.
        - `type` string
        - `contentHash` string: SHA-256 hash of the canonicalised statement (proof field excluded).
        - `jws` string: Ed25519 JWS over the content hash.
        - `verificationMethod` string

## Other responses

- `404`: Entity or resource not found.

---

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