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

# FQL Examples

> Real-world FQL query examples for common business scenarios

## Investment Research

<AccordionGroup>
  <Accordion title="High-Growth Potential Tech Companies" icon="chart-line">
    Find mid-sized tech companies in major hubs:

    ```
    (State IN ['Maharashtra', 'Karnataka', 'Tamil Nadu']) AND
    (NICDesc CONTAINS 'software' OR NICDesc CONTAINS 'technology') AND
    (paidUpCapital > 1000000 AND paidUpCapital < 50000000) AND
    dateOfIncorporation > '2018-01-01' AND
    llpStatus == 'Active'
    ```

    **Use Case**: Target recently incorporated tech companies with growth potential.
  </Accordion>

  <Accordion title="Listed Companies by Capital" icon="building">
    Find publicly listed companies with significant capital:

    ```
    Listed == 'Listed' AND paidUpCapital > 100000000 AND State == 'Maharashtra'
    ```
  </Accordion>

  <Accordion title="Well-Funded Startups" icon="rocket">
    Find private companies with high capital, recently incorporated:

    ```
    classOfCompany == 'Private' AND
    paidUpCapital > 50000000 AND
    dateOfIncorporation > '2020-01-01' AND
    llpStatus == 'Active'
    ```
  </Accordion>
</AccordionGroup>

## Lead Generation

<AccordionGroup>
  <Accordion title="Manufacturing Companies in Industrial Zones" icon="industry">
    ```
    NICDesc CONTAINS 'manufacturing' AND
    City IN ['Pune', 'Chennai', 'Ahmedabad'] AND
    paidUpCapital > 5000000 AND
    llpStatus == 'Active'
    ```
  </Accordion>

  <Accordion title="IT Services Companies" icon="computer">
    ```
    (NICCode IN [62011, 62012, 62013]) AND
    City IN ['Bangalore', 'Hyderabad', 'Pune'] AND
    paidUpCapital > 1000000
    ```
  </Accordion>

  <Accordion title="Retail Businesses by Region" icon="store">
    ```
    NICDesc CONTAINS 'retail' AND
    State == 'Delhi' AND
    llpStatus == 'Active'
    ```
  </Accordion>
</AccordionGroup>

## Compliance Monitoring

<AccordionGroup>
  <Accordion title="High-Risk GST Entities" icon="triangle-exclamation">
    Identify entities with potential compliance issues:

    ```
    (Status != 'Active' OR TaxpayerType == 'Composition') AND
    Turnover > 20000000 AND
    (ConstitutionBusiness == 'Proprietorship' OR ConstitutionBusiness == 'Partnership')
    ```
  </Accordion>

  <Accordion title="Recently Suspended GST Registrations" icon="ban">
    ```
    Status == 'Suspended' AND state == 'Maharashtra'
    ```
  </Accordion>

  <Accordion title="Dormant Companies" icon="moon">
    ```
    llpStatus == 'Dormant' AND State == 'Maharashtra'
    ```
  </Accordion>
</AccordionGroup>

## Market Research

<AccordionGroup>
  <Accordion title="New Market Entrants" icon="door-open">
    Companies incorporated in the last year:

    ```
    dateOfIncorporation > '2024-01-01' AND
    State == 'Karnataka' AND
    llpStatus == 'Active'
    ```
  </Accordion>

  <Accordion title="E-commerce Companies" icon="cart-shopping">
    ```
    (NICDesc CONTAINS 'e-commerce' OR NICDesc CONTAINS 'electronic commerce') AND
    paidUpCapital > 1000000
    ```
  </Accordion>

  <Accordion title="Financial Services" icon="landmark">
    ```
    (NICCode IN [64191, 64192, 65110]) AND
    llpStatus == 'Active' AND
    paidUpCapital > 10000000
    ```
  </Accordion>
</AccordionGroup>

## Regional Analysis

<AccordionGroup>
  <Accordion title="Tier 2 Cities Growth" icon="city">
    ```
    City IN ['Jaipur', 'Lucknow', 'Indore', 'Kochi', 'Chandigarh'] AND
    dateOfIncorporation > '2022-01-01' AND
    llpStatus == 'Active'
    ```
  </Accordion>

  <Accordion title="Multi-State Comparison" icon="map">
    Compare tech companies across states:

    ```
    (State IN ['Maharashtra', 'Karnataka', 'Tamil Nadu', 'Telangana']) AND
    NICDesc CONTAINS 'software' AND
    paidUpCapital > 5000000
    ```
  </Accordion>
</AccordionGroup>

## Query Optimization Tips

<CardGroup cols={2}>
  <Card title="Filter Early" icon="filter">
    Put most selective conditions first:

    ```
    Turnover > 100000000 AND City == 'Mumbai'
    ```
  </Card>

  <Card title="Use IN for Multiple Values" icon="list">
    More efficient than multiple OR conditions:

    ```
    City IN ['Mumbai', 'Delhi', 'Bangalore']
    ```
  </Card>

  <Card title="Indexed Fields First" icon="bolt">
    Fields like City, State, Status are indexed and faster to query.
  </Card>

  <Card title="Limit Date Ranges" icon="calendar">
    Narrow date ranges improve performance:

    ```
    dateOfIncorporation > '2023-01-01' AND dateOfIncorporation < '2024-01-01'
    ```
  </Card>
</CardGroup>
