# Search specific financial metrics

**API:** Data API

**Endpoint:** `POST /v1/beta/financial/financials/search/line-items`

**Tags:** Financial Data

Pull named financial line items across one or more companies in a single call. Body takes `tickers` and `line_items` (both required, both arrays), plus `period` (annual, quarterly or ttm) and `limit`. Returns `search_results` with one row per ticker and period carrying only the fields you asked for, alongside `report_period`, `period` and `currency`. Use it to build a comparison table without pulling three full statements per company. The item names are the same field names the statement tools return, so look one up there first if unsure. For everything about a single company use `get_financial_financials`.

### Pricing reference

- Metering: Fixed successful-request cost basis.
- Reference request estimate: USD 0.02.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "required": [
    "line_items",
    "tickers"
  ],
  "properties": {
    "line_items": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "The financial metric to search for."
      },
      "minItems": 1,
      "description": "An array of line items to apply to the search."
    },
    "tickers": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "The tickers to search for."
      },
      "minItems": 1,
      "description": "An array of tickers to apply to the search."
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "ttm",
      "description": "The time period for the financial data."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "The maximum number of results to return."
    }
  }
}
```

## Responses

### 200 — Successful search response

Headers:
- `X-Request-Id` (string) — Request identifier to include when contacting Felo support.

**application/json**

Schema: `ResponseE40Feb4D3D6B_FinancialsSearchResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsSearchResponse`)

### 400 — The request could not be processed. Check the request parameters.

### 401 — A valid Felo API key is required.

### 402 — The request cannot proceed because a billing requirement is not met.

### 403 — The account is not permitted to perform this operation.

### 429 — A request or spending limit has been reached.

### 502 — The service could not complete the request.

### 503 — The API or billing service is temporarily unavailable.

### 504 — The service timed out while processing the request.

### default — Error response; upstream passthrough responses may use provider formats

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_FinancialsSearchResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsSearchResponse`

```json
{
  "type": "object",
  "properties": {
    "search_results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string",
            "description": "The ticker symbol of the company."
          },
          "report_period": {
            "type": "string",
            "format": "date",
            "description": "The reporting period of the financial data."
          },
          "period": {
            "type": "string",
            "enum": [
              "annual",
              "quarterly",
              "ttm"
            ],
            "description": "The time period of the financial data."
          },
          "currency": {
            "type": "string",
            "description": "The currency of the financial data."
          }
        },
        "additionalProperties": {
          "type": "string",
          "description": "Additional financial metrics based on the search criteria."
        }
      }
    }
  }
}
```