> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Financial metrics for public companies (Bulk)

<AccordionGroup>
  <Accordion title="How It Works">
    * **Input:** Provide a list of up to **`50business_ids`**.
    * **Processing:** The system retrieves financial metrics data for all submitted businesses in a **single request**.
    * **Output:** A structured response with key financial indicators.
  </Accordion>

  <Accordion title="Example Request (cURL)">
    ```shell Bash theme={null}
    curl --request POST \
         --url https://api.explorium.ai/v1/businesses/financial_indicators/bulk_enrich \
         --header 'accept: application/json' \
         --header 'api_key: your_api_key_here' \
         --header 'content-type: application/json' \
         --data '{
      "business_ids": [
        "8adce3ca1cef0c986b22310e369a0793",
        "a34bacf839b923770b2c360eefa26748"
      ]
    }'
    ```
  </Accordion>

  <Accordion title="Best Practices">
    * **Analyze revenue trends** to assess financial stability.
    * **Compare profitability metrics** to evaluate business performance.
    * **Monitor investment returns** to track growth and market value.
  </Accordion>
</AccordionGroup>

<Icon icon="thumbtack" iconType="solid" color="red" /> **For additional enrichment options, explore related API endpoints below.**

## Body Params - Try Me Example

```
business_ids: ["8adce3ca1cef0c986b22310e369a0793", "a34bacf839b923770b2c360eefa26748"]
```


## OpenAPI

````yaml post /v1/businesses/financial_indicators/bulk_enrich
openapi: 3.1.0
info:
  title: Partner Service
  version: 0.2.349
servers:
  - url: https://api.explorium.ai
    description: AgentSource Server
security: []
paths:
  /v1/businesses/financial_indicators/bulk_enrich:
    post:
      tags:
        - BulkBusinessEnrichments
      summary: Financial Indicators
      operationId: businesses_financial_indicators_bulk_enrich
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FinancialIndicatorsBulkEnrichRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/BusinessesBulkEnrichResponse_FinancialIndicatorsOutputSchema_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - APIKeyHeader: []
components:
  schemas:
    FinancialIndicatorsBulkEnrichRequest:
      properties:
        request_context:
          type: object
          title: Request Context
          example: null
          nullable: true
        parameters:
          $ref: '#/components/schemas/FinancialIndicatorsEnrichmentParams'
        business_ids:
          items:
            type: string
            pattern: ^[a-f0-9]{32}$
          type: array
          maxItems: 50
          minItems: 1
          title: Business Ids
      additionalProperties: false
      type: object
      required:
        - business_ids
      title: FinancialIndicatorsBulkEnrichRequest
    BusinessesBulkEnrichResponse_FinancialIndicatorsOutputSchema_:
      properties:
        response_context:
          $ref: '#/components/schemas/ResponseContext'
        data:
          items:
            $ref: >-
              #/components/schemas/BusinessesBulkEnrichRow_FinancialIndicatorsOutputSchema_
          type: array
          title: Data
        entity_id:
          anyOf:
            - type: string
              pattern: ^[a-f0-9]{32}$
            - type: string
              pattern: ^[a-f0-9]{40}$
          title: Entity Id
        total_results:
          type: integer
          title: Total Results
      type: object
      required:
        - response_context
        - total_results
      title: BusinessesBulkEnrichResponse[FinancialIndicatorsOutputSchema]
      description: 'This is base response model for all responses in partner service. '
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FinancialIndicatorsEnrichmentParams:
      properties:
        date:
          type: string
          format: date-time
          title: Date
      additionalProperties: false
      type: object
      required:
        - date
      title: FinancialIndicatorsEnrichmentParams
    ResponseContext:
      properties:
        correlation_id:
          type: string
          title: Correlation Id
        request_status:
          $ref: '#/components/schemas/RequestStatus'
        time_took_in_seconds:
          type: number
          title: Time Took In Seconds
      type: object
      required:
        - correlation_id
        - request_status
        - time_took_in_seconds
      title: ResponseContext
    BusinessesBulkEnrichRow_FinancialIndicatorsOutputSchema_:
      properties:
        business_id:
          type: string
          pattern: ^[a-f0-9]{32}$
          title: Business Id
        data:
          $ref: '#/components/schemas/FinancialIndicatorsOutputSchema'
      type: object
      required:
        - business_id
      title: BusinessesBulkEnrichRow[FinancialIndicatorsOutputSchema]
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    RequestStatus:
      type: string
      enum:
        - success
        - miss
        - failure
      title: RequestStatus
      description: >-
        The `RequestStatus` class is an enumeration that defines the possible
        statuses of a request.


        This enum is used to indicate whether a request was successful, missed,
        or failed. It ensures

        consistent handling of request statuses across the application.


        Attributes:
            SUCCESS: Indicates that the request was successfully processed.
            MISS: Indicates that the request did not find any matching data.
            FAILURE: Indicates that the request encountered an error or failure.
    FinancialIndicatorsOutputSchema:
      properties:
        asset_turnover:
          type: number
          title: Asset Turnover
        cagr:
          type: number
          title: Cagr
        cogs:
          type: number
          title: Cogs
        earnings_surprises:
          additionalProperties:
            type: string
          type: object
          title: Earnings Surprises
        cash_and_cash_equivalents:
          type: number
          title: Cash And Cash Equivalents
        ebitda:
          type: number
          title: Ebitda
        enterprise_value_over_ebitda:
          type: number
          title: Enterprise Value Over Ebitda
        leadership:
          items:
            additionalProperties:
              type: string
            type: object
          type: array
          title: Leadership
        peer_companies:
          additionalProperties:
            type: string
          type: object
          title: Peer Companies
        price_earnings_ratio:
          type: number
          title: Price Earnings Ratio
        revenue_yearly:
          type: number
          title: Revenue Yearly
        roa:
          type: number
          title: Roa
        roc:
          type: number
          title: Roc
        sg_and_a:
          type: number
          title: Sg And A
        tsr_1y:
          type: number
          title: Tsr 1Y
        tsr_3y:
          type: number
          title: Tsr 3Y
        tsr_5y:
          type: number
          title: Tsr 5Y
        working_capital:
          type: number
          title: Working Capital
      type: object
      title: FinancialIndicatorsOutputSchema
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: api_key

````