---
title: "Retrieve a signed verification record"
method: GET
path: "/api/records/{record_id}"
tags: ["Verification Records"]
---

# Retrieve a signed verification record

`GET /api/records/{record_id}`

## Request

- Base URL: `https://flint.network`
- URL: `https://flint.network/api/records/{record_id}`
- Auth: none required

Returns the portable hybrid envelope by default, a bare ES256 compact JWS for format=jws, or a decoded inspection view for format=decoded. The decoded view is not itself signed.

## Path parameters

- `record_id` string, required

## Query parameters

- `format` 'decoded' | 'jws'

## Response `200`

Stored record in the requested representation.

- union
  - HybridEnvelopeWithAcknowledgments
    - `envelope_version` string, nullable
    - `jws` string, required: ES256 compact JWS.
    - `pq_signature` string, nullable: Parallel ML-DSA-65 signature when configured.
    - `pq_kid` string, nullable
    - `pq_alg` string, nullable
    - `acknowledgments` RecordAcknowledgment[], required
      - `received_at` string, date-time, required
      - `acknowledger` object, required
        - `agent_id` string, required
        - `passport_id` string, nullable, required
        - `wallet_address` string, nullable, required
      - `signature_status` 'verified' | 'unverified_claim', required
      - `method` 'none' | 'es256_jws' | 'eip191_wallet' | 'unsupported', required
  - DecodedRecordResponse
    - `header` object, required
    - `envelope_version` string, nullable, required
    - `pq_signature` object, required
      - `present` boolean, required
      - `alg` string, nullable
      - `kid` string, nullable
    - `record` object, required: Decoded record payload. This view is not itself signed.
    - `acknowledgments` RecordAcknowledgment[], required
      - `received_at` string, date-time, required
      - `acknowledger` object, required
        - `agent_id` string, required
        - `passport_id` string, nullable, required
        - `wallet_address` string, nullable, required
      - `signature_status` 'verified' | 'unverified_claim', required
      - `method` 'none' | 'es256_jws' | 'eip191_wallet' | 'unsupported', required
    - `settlement_receipt` object, nullable, required
      - `receipt_id` string, required
      - `href` string, required

## Other responses

- `400`: Invalid request
- `404`: Resource not found
- `500`: Server error

---

[API](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api.md) · [All operations](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flint/apis/flint-agent-transaction-control-api/revisions/eb5052b7b5dc?raw)