---
title: "Latest Equity Financials"
method: GET
path: "/gateway/v1/equity/latest-financials"
tags: ["Equity"]
---

# Latest Equity Financials

`GET /gateway/v1/equity/latest-financials`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/equity/latest-financials`
- Auth: HTTP bearer

Returns the most recently published current-serving TTM financials across US equities. Use market_cap_min to include only companies above an explicit current-serving market capitalization threshold in USD. One company per reporting series, ranked by the current publication's SEC accepted_at then filed_on.

## Query parameters

- `limit` integer: Maximum companies to return
- `market_cap_min` number, double, nullable: Optional minimum current market capitalization in USD; omit to disable this filter

## Response `200`

OK

- DataResponseEquityLatestFinancialsItem
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` EquityLatestFinancialsItem[], nullable, required
    - `company_name` string, required: Company display name
    - `duration_days` integer: Inclusive TTM period duration in days
    - `duration_months` integer: Deprecated compatibility duration in months; use duration_days
    - `filed_on` string, required: Latest periodic SEC filing date in YYYY-MM-DD format
    - `free_cash_flow` EquityMetricValue, required
      - `applicability_version` string: Applicability version used for this metric cell
      - `formula_version` string: Formula version used for this metric cell
      - `quality_reason_codes` string[], nullable: Serving-layer quality reason codes
      - `reason_code` string: Opaque serving-layer reason when a metric is unavailable
      - `source_accessions` string[], nullable: Source filing accession identifiers
      - `source_financial_metric_snapshot_ids` string[], nullable: Source provider metric snapshot identifiers
      - `source_revision_ids` string[], nullable: Source statement revision identifiers
      - `source_statement_ids` string[], nullable: Source financial statement identifiers
      - `status` 'available' | 'missing' | 'not_applicable', required: Availability status
      - `value` number, double, nullable, required: Exact metric value. Null when missing or not applicable.
      - `value_origin` 'reported' | 'derived': Whether the value is reported or derived
    - `gross_margin` EquityMetricValue, required
      - `applicability_version` string: Applicability version used for this metric cell
      - `formula_version` string: Formula version used for this metric cell
      - `quality_reason_codes` string[], nullable: Serving-layer quality reason codes
      - `reason_code` string: Opaque serving-layer reason when a metric is unavailable
      - `source_accessions` string[], nullable: Source filing accession identifiers
      - `source_financial_metric_snapshot_ids` string[], nullable: Source provider metric snapshot identifiers
      - `source_revision_ids` string[], nullable: Source statement revision identifiers
      - `source_statement_ids` string[], nullable: Source financial statement identifiers
      - `status` 'available' | 'missing' | 'not_applicable', required: Availability status
      - `value` number, double, nullable, required: Exact metric value. Null when missing or not applicable.
      - `value_origin` 'reported' | 'derived': Whether the value is reported or derived
    - `logo_url` string, required: Company logo image URL
    - `operating_margin` EquityMetricValue, required
      - `applicability_version` string: Applicability version used for this metric cell
      - `formula_version` string: Formula version used for this metric cell
      - `quality_reason_codes` string[], nullable: Serving-layer quality reason codes
      - `reason_code` string: Opaque serving-layer reason when a metric is unavailable
      - `source_accessions` string[], nullable: Source filing accession identifiers
      - `source_financial_metric_snapshot_ids` string[], nullable: Source provider metric snapshot identifiers
      - `source_revision_ids` string[], nullable: Source statement revision identifiers
      - `source_statement_ids` string[], nullable: Source financial statement identifiers
      - `status` 'available' | 'missing' | 'not_applicable', required: Availability status
      - `value` number, double, nullable, required: Exact metric value. Null when missing or not applicable.
      - `value_origin` 'reported' | 'derived': Whether the value is reported or derived
    - `pe_ttm` EquityMetricValue, required
      - `applicability_version` string: Applicability version used for this metric cell
      - `formula_version` string: Formula version used for this metric cell
      - `quality_reason_codes` string[], nullable: Serving-layer quality reason codes
      - `reason_code` string: Opaque serving-layer reason when a metric is unavailable
      - `source_accessions` string[], nullable: Source filing accession identifiers
      - `source_financial_metric_snapshot_ids` string[], nullable: Source provider metric snapshot identifiers
      - `source_revision_ids` string[], nullable: Source statement revision identifiers
      - `source_statement_ids` string[], nullable: Source financial statement identifiers
      - `status` 'available' | 'missing' | 'not_applicable', required: Availability status
      - `value` number, double, nullable, required: Exact metric value. Null when missing or not applicable.
      - `value_origin` 'reported' | 'derived': Whether the value is reported or derived
    - `period_start` string: Inclusive TTM period start date in YYYY-MM-DD format
    - `report_period` string, required: TTM period end date in YYYY-MM-DD format
    - `return_on_equity` EquityMetricValue, required
      - `applicability_version` string: Applicability version used for this metric cell
      - `formula_version` string: Formula version used for this metric cell
      - `quality_reason_codes` string[], nullable: Serving-layer quality reason codes
      - `reason_code` string: Opaque serving-layer reason when a metric is unavailable
      - `source_accessions` string[], nullable: Source filing accession identifiers
      - `source_financial_metric_snapshot_ids` string[], nullable: Source provider metric snapshot identifiers
      - `source_revision_ids` string[], nullable: Source statement revision identifiers
      - `source_statement_ids` string[], nullable: Source financial statement identifiers
      - `status` 'available' | 'missing' | 'not_applicable', required: Availability status
      - `value` number, double, nullable, required: Exact metric value. Null when missing or not applicable.
      - `value_origin` 'reported' | 'derived': Whether the value is reported or derived
    - `revenue_growth` EquityMetricValue, required
      - `applicability_version` string: Applicability version used for this metric cell
      - `formula_version` string: Formula version used for this metric cell
      - `quality_reason_codes` string[], nullable: Serving-layer quality reason codes
      - `reason_code` string: Opaque serving-layer reason when a metric is unavailable
      - `source_accessions` string[], nullable: Source filing accession identifiers
      - `source_financial_metric_snapshot_ids` string[], nullable: Source provider metric snapshot identifiers
      - `source_revision_ids` string[], nullable: Source statement revision identifiers
      - `source_statement_ids` string[], nullable: Source financial statement identifiers
      - `status` 'available' | 'missing' | 'not_applicable', required: Availability status
      - `value` number, double, nullable, required: Exact metric value. Null when missing or not applicable.
      - `value_origin` 'reported' | 'derived': Whether the value is reported or derived
    - `source_updated_at` integer: Latest source update time as Unix seconds
    - `symbol` string, required: Primary current verified stock ticker
  - `meta` OffsetMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
    - `limit` integer, required: Maximum number of items returned in this response
    - `offset` integer, required: Number of items skipped (pagination offset)
    - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown.
    - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)