> ## 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.

# List Screeners

> List saved screener queries

Retrieve all saved screener queries visible to the authenticated user.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token: `Bearer <access_token>`
</ParamField>

## Response

<ResponseField name="data" type="array">
  <Expandable title="items">
    <ResponseField name="id" type="string">
      Screener ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Screener name
    </ResponseField>

    <ResponseField name="type" type="string">
      Entity type (company or gst)
    </ResponseField>

    <ResponseField name="query" type="string">
      FQL query string
    </ResponseField>

    <ResponseField name="description" type="string">
      Screener description
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Creation timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.finscreener.in/api/screener/screeners" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "id": "scr_123",
        "name": "Mumbai IT Companies",
        "type": "company",
        "query": "City == 'Mumbai' AND NICCode IN [62011, 62012]",
        "description": "IT companies in Mumbai",
        "created_at": "2026-01-15T10:30:00Z"
      },
      {
        "id": "scr_456",
        "name": "Active GST Karnataka",
        "type": "gst",
        "query": "state == 'Karnataka' AND Status == 'Active'",
        "description": null,
        "created_at": "2026-01-10T14:20:00Z"
      }
    ]
  }
  ```
</ResponseExample>