---
title: "GET /api/me/reporting/v2/snapshots/:snapshot_id"
method: GET
path: "/api/me/reporting/v2/snapshots/{snapshot_id}"
tags: ["reporting"]
---

# GET /api/me/reporting/v2/snapshots/:snapshot_id

`GET /api/me/reporting/v2/snapshots/{snapshot_id}`

## Request

- Base URL: `https://api.aifinpay.io`
- URL: `https://api.aifinpay.io/api/me/reporting/v2/snapshots/{snapshot_id}`
- Auth: API key in cookie `__aifinpay_user_session`

Reporting v2: observations never authorize payments or access. Current scope and explicit coverage; no-store. Default-off operator flag; independent approval and deployment are separate.

## Path parameters

- `snapshot_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Evidence-bound reporting response

- ReportingSnapshot
  - `version` 2, required
  - `contract` 'reporting.v2.20261009', required
  - `snapshot_id` string, uuid, required
  - `as_of` string, date-time, required
  - `expires_at` string, date-time, required
  - `filters` ReportingFilters, required
    - `funnel` 'access' | 'onboarding' | 'sites', required
    - `merchant_ids` string[], required
    - `from` string, date-time, required
    - `to` string, date-time, required
    - `resource` string
    - `channel` 'browser' | 'api' | 'unknown'
    - `source` 'hosted' | 'partner' | 'browser'
    - `network` string
    - `mode` 'live' | 'test' | 'internal'
  - `summary` ReportingSummary, required
    - `events` string, nullable, required
    - `observed_unique_clients` string, nullable, required
    - `unknown_identity_events` string, nullable, required
    - `linked_payments` string, nullable, required
    - `unlinked_payments` string, nullable, required
    - `unique_paying_wallets` string, nullable, required
    - `financial` object, required
      - `assigned_payments` string, nullable, required
      - `valued_payments` string, nullable, required
      - `gross_usd_micros` string, nullable, required
      - `status` 'empty' | 'valued' | 'unpriced' | 'partial' | 'unsupported' | 'unavailable', required
    - `merchants` object
      - `registered_sites` string, nullable, required
      - `reported_sites` string, nullable, required
      - `verified_sites` string, nullable, required
      - `first_paid_sites` string, nullable, required
  - `stages` ReportingStage[], required
    - `name` 'access_challenged' | 'access_admitted' | 'resource_response_completed' | 'paywall_viewed' | 'payment_link_opened' | 'merchant_onboarding_opened' | 'quote_created' | 'payment_confirmed' | 'merchant_signup_completed' | 'merchant_site_created' | 'merchant_integration_reported' | 'merchant_integration_verified' | 'merchant_first_payment_confirmed', required
    - `count` string, nullable, required
    - `unit` 'event' | 'flow' | 'site' | 'account' | 'quote' | 'settlement', required
    - `trust` 'observed' | 'authoritative' | 'ledger', required
    - `status` 'supported' | 'partial' | 'not_instrumented' | 'not_applicable' | 'unavailable' | 'suppressed', required
    - `tracking_start` string, date-time, nullable, required
    - `source` string, nullable, required
    - `last_received` string, date-time, nullable
  - `cohorts` ReportingCohort[], required
    - `pair` string, required
    - `unit` 'flow' | 'site', required
    - `denominator` string, nullable, required
    - `numerator` string, nullable, required
    - `channel` 'browser' | 'api' | 'unknown' | 'null', nullable, required
    - `rate` number, nullable, required
    - `window_seconds` 604800, required
    - `maturity` 'mature' | 'immature', required
    - `quality` string, required
  - `coverage` ReportingCoverage, required
    - `raw_from` string, date-time, nullable, required
    - `projection_lag_seconds` number, nullable, required
    - `pending` union, required
      - string, nullable
      - integer
    - `dropped` string, nullable, required
    - `interruptions` object[], required
    - `integration_status` string, required
    - `integration_reason` string, nullable, required
    - `stage_coverage` object[]
    - `source_coverage` object[]
    - `verifications` object[]
      - `merchant_id` string, required
      - `status` 'verified' | 'incomplete', required
      - `reason` string, nullable, required
      - `last_checked_at` string, date-time, nullable, required
      - `current_revision` string, required
      - `verified_at` string, date-time, nullable, required
      - `checks` object[], required
        - `name` string, required
        - `passed` boolean, required
        - `evidence_ref` string, required
    - `supported_stages` string[]
    - `last_received` object
    - `tracking_start` object
    - `producer_status` 'unknown' | 'gap' | 'reported'
    - `producers` object[]
      - `producer_id` string, uuid, required
      - `sequence` string, nullable, required
      - `pending` string, nullable, required
      - `dropped` string, nullable, required
      - `retries` string, nullable, required
      - `last_error` string, required
      - `at` string, date-time, required
      - `supported` string[], required
    - `financial_status` 'empty' | 'valued' | 'unpriced' | 'partial' | 'unsupported' | 'unavailable'
    - `attribution` object
      - `linked` string, nullable, required
      - `eligible` string, nullable, required
      - `ratio` number, nullable, required
  - `rows` ReportingRow[], required
    - `row_id` string, required
    - `identity_type` 'unknown' | 'observed_client' | 'confirmed_payer' | 'merchant_owner', required
    - `identity_id` string, uuid, nullable, required
    - `flow_id` string, uuid, nullable, required
    - `merchant_id` string, nullable, required
    - `resource` string, nullable, required
    - `stage` 'access_challenged' | 'access_admitted' | 'resource_response_completed' | 'paywall_viewed' | 'payment_link_opened' | 'merchant_onboarding_opened' | 'quote_created' | 'payment_confirmed' | 'merchant_signup_completed' | 'merchant_site_created' | 'merchant_integration_reported' | 'merchant_integration_verified' | 'merchant_first_payment_confirmed', required
    - `occurred_at` string, date-time, required
    - `received_at` string, date-time, required
    - `source` string, required
    - `trust` 'observed' | 'authoritative' | 'ledger', required
    - `channel` 'browser' | 'api' | 'unknown', required
    - `mode` 'live' | 'test' | 'internal', required
    - `outcome` 'success' | 'redirect' | 'error' | 'abort' | 'null', nullable, required
    - `reason` string, nullable, required
    - `evidence_ref` string, nullable, required
    - `quote_id` string, nullable, required
    - `settlement_ref` string, nullable, required
    - `asset` string, nullable, required
    - `base_units` string, nullable, required
    - `decimals` string, nullable, required
    - `usd_micros` string, nullable, required
  - `page` object, required
    - `total_rows` string, required
    - `exported_rows` integer, required
    - `truncated` boolean, required
    - `next_cursor` string, nullable, required
  - `merchants` object
    - `registered_sites` string, nullable, required
    - `reported_sites` string, nullable, required
    - `verified_sites` string, nullable, required
    - `first_paid_sites` string, nullable, required

## Other responses

- `400`: Safe reporting error; no payload or credential echo
- `401`: Safe reporting error; no payload or credential echo
- `403`: Safe reporting error; no payload or credential echo
- `404`: Safe reporting error; no payload or credential echo
- `409`: Safe reporting error; no payload or credential echo
- `410`: Safe reporting error; no payload or credential echo
- `413`: Safe reporting error; no payload or credential echo
- `422`: Safe reporting error; no payload or credential echo
- `429`: Safe reporting error; no payload or credential echo
- `503`: Safe reporting error; no payload or credential echo

---

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