---
title: "List FININT indicators"
description: "Lists dimension-filtered FININT indicators from the same data as `GET /api/v1/osint/finint`, using the `intel:finint` scope and ontology-aware filters."
canonical: https://y2.dev/docs/api/reference/intel/listFinintIntelV2/
---

Endpoint Reference[Intel](https://y2.dev/docs/api/reference/intel)

# List FININT indicators

Lists dimension-filtered FININT indicators from the same data as \`GET /api/v1/osint/finint\`, using the \`intel:finint\` scope and ontology-aware filters.

`GET https://api.y2.dev/api/v2/finint`

- Operation ID: `listFinintIntelV2`
- Required scopes: `intel:finint`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | string | No | Opaque continuation token from the previous response. Bound to the original filters and ordering. |
| `fields[finint]` | query | string | No | Comma-separated allowlist of financial observation fields (indicator, source, dimension, measurement, observedAt, period, provenance, entities, geometry, signals). Identity remains present. |
| `dimensionType` | query | `facility`, `rto`, `port`, `state` | No | Restrict to per-dimension rows (e.g. `facility`, `rto`, `port`, `state`) |
| `dimension` | query | string | No | Exact dimension key (e.g. `PJM`, `vogtle`, `houston`) |
| `indicatorId` | query | string | No | Exact indicator key (e.g. `EIA:WTI`, `FRED:DGS10`) |
| `category` | query | `rates`, `credit`, `inflation`, `labor`, `gdp`, `business`, `consumer`, `housing`, `money_supply`, `volatility`, `commodities`, `fx`, `equities`, `energy`, `crypto` | No | Filter by indicator category |
| `source` | query | `fred`, `yfinance`, `eia` | No | Filter by data source |
| `limit` | query | integer | No | Maximum number of indicators to return |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | List of FinInt indicators | `FinintIntelListResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `PublicFinintObservation` |  |
| `data[].id` | string |  |
| `data[].type` | string |  |
| `data[].indicator` | object |  |
| `data[].source` | object |  |
| `data[].dimension` | object or null |  |
| `data[].measurement` | object |  |
| `data[].observedAt` | string (date-time) | Existing cache fetch timestamp, not a provider quote time, reporting period, or original publication date. |
| `data[].period` | `FinintPeriod` | Provider reporting label or a timestamp tied to the selected quote. Labels are not inferred UTC boundaries. Null when the adapter has no supported timing. Never inferred from fetch time. |
| `data[].provenance` | `FinintProvenance` | Bounded provider metadata retained with the current cached value, not an archived source payload or evidence of original publication/availability. Null for rows without captured metadata. This feed does not retain historical vintages. |
| `data[].entities[]` | array of object | Up to eight existing canonical ontology entity links per observation, with a lookup budget of 1000 distinct entity IDs across the page. Unresolved or over-budget references are omitted. No company identity is inferred from a ticker. Does not include tenant research or financial history. |
| `data[].geometry` | `GeoJSONPoint` | WGS 84 point with longitude first, then latitude. |
| `data[].signals[]` | array of string |  |
| `meta` | `PublicListMeta` |  |
| `meta.count` | integer |  |
| `meta.pageCount` | integer |  |
| `meta.limit` | integer |  |
| `meta.isDone` | boolean |  |
| `meta.hasMore` | boolean |  |
| `meta.nextCursor` | string or null |  |
| `meta.asOf` | string (date-time) |  |
| `meta.page` | `PublicPageMeta` |  |
| `links` | `PublicCollectionLinks` |  |
| `links.self` | string |  |
| `links.next` | string or null |  |
