---
title: "Guidance Bias"
method: POST
path: "/v0/filings/guidance_bias"
tags: ["V0", "Filings", "HAS_MCP_EQUIVALENT"]
---

# Guidance Bias

`POST /v0/filings/guidance_bias`

## Request

- Base URL: `https://api.ultralayer.ai`
- URL: `https://api.ultralayer.ai/v0/filings/guidance_bias`
- Auth: HTTP bearer

Aggregate score of company guidance versus reported actuals. One point per report period.

## Request body

- GuidanceBiasParams
  - `symbol` string, required: Listing symbol of the filer.
  - `start_timestamp` string, date-time, nullable: System timestamp; Inclusive ISO 8601
  - `end_timestamp` string, date-time, nullable: System timestamp; Inclusive ISO 8601; null=realtime

## Response `200`

Guidance-bias time series.

- GuidanceBias[]
  - `symbol` string, required: Listing symbol of the filer.
  - `company_name` string, nullable, required: Filer name.
  - `cik` integer, nullable, required: SEC CIK of the filer.
  - `timestamp` string, date-time, required: System timestamp of the latest actual in this period.
  - `source_timestamp` string, date-time, required: When the latest actual in this period became public.
  - `fiscal_year` integer, required: Filer fiscal year of the report that printed the actual.
  - `fiscal_quarter` integer, nullable, required: Filer fiscal quarter of that report; null for a full-year report.
  - `bias_score` number, required: Mean of mapped labels: significantly_exceeded=2, exceeded=1, in_line=0, missed=-1, significantly_missed=-2.
  - `resolved_count` integer, required: Resolved outcomes in the mean.
  - `label_counts` object, required: Resolved label counts in the mean.

## Other responses

- `422`: Validation Error

---

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