curl -X POST https://api.finscreener.in/api/screener/search \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "State == '\''Maharashtra'\'' AND paidUpCapital > 5000000",
"type": "company",
"page": 1,
"limit": 10
}'
import requests
response = requests.post(
"https://api.finscreener.in/api/screener/search",
headers={"Authorization": f"Bearer {token}"},
json={
"query": "State == 'Maharashtra' AND paidUpCapital > 5000000",
"type": "company",
"page": 1,
"limit": 10
}
)
results = response.json()
const response = await fetch('https://api.finscreener.in/api/screener/search', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
query: "State == 'Maharashtra' AND paidUpCapital > 5000000",
type: 'company',
page: 1,
limit: 10
})
});
const results = await response.json();
{
"results": [
{
"CIN": "L17110MH1973PLC019786",
"companyName": "RELIANCE INDUSTRIES LIMITED",
"State": "Maharashtra",
"City": "Mumbai",
"paidUpCapital": 6766000000,
"llpStatus": "Active"
}
],
"total": 1523,
"page": 1,
"pages": 153
}
{
"results": [
{
"GSTIN": "27AAACR5055K1ZZ",
"TradeName": "RELIANCE INDUSTRIES LIMITED",
"state": "Maharashtra",
"Status": "Active",
"TaxpayerType": "Regular"
}
],
"total": 892,
"page": 1,
"pages": 90
}
Screener
Screener Search
Search using FQL screener query
POST
/
api
/
screener
/
search
curl -X POST https://api.finscreener.in/api/screener/search \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "State == '\''Maharashtra'\'' AND paidUpCapital > 5000000",
"type": "company",
"page": 1,
"limit": 10
}'
import requests
response = requests.post(
"https://api.finscreener.in/api/screener/search",
headers={"Authorization": f"Bearer {token}"},
json={
"query": "State == 'Maharashtra' AND paidUpCapital > 5000000",
"type": "company",
"page": 1,
"limit": 10
}
)
results = response.json()
const response = await fetch('https://api.finscreener.in/api/screener/search', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
query: "State == 'Maharashtra' AND paidUpCapital > 5000000",
type: 'company',
page: 1,
limit: 10
})
});
const results = await response.json();
{
"results": [
{
"CIN": "L17110MH1973PLC019786",
"companyName": "RELIANCE INDUSTRIES LIMITED",
"State": "Maharashtra",
"City": "Mumbai",
"paidUpCapital": 6766000000,
"llpStatus": "Active"
}
],
"total": 1523,
"page": 1,
"pages": 153
}
{
"results": [
{
"GSTIN": "27AAACR5055K1ZZ",
"TradeName": "RELIANCE INDUSTRIES LIMITED",
"state": "Maharashtra",
"Status": "Active",
"TaxpayerType": "Regular"
}
],
"total": 892,
"page": 1,
"pages": 90
}
Execute an FQL (Finscreener Query Language) query to search and filter companies or GST registrations.
Headers
string
required
Bearer token:
Bearer <access_token>Request Body
string
required
FQL query string (e.g.,
state == 'Maharashtra' AND paidUpCapital > 5000000)string
required
Entity type:
company or gstnumber
default:"1"
Page number
number
default:"10"
Results per page (max: 100)
Field names are case-sensitive! Company fields use PascalCase (
City, State, NICCode), GST fields use mixed case (state, Status, TaxpayerType).curl -X POST https://api.finscreener.in/api/screener/search \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"query": "State == '\''Maharashtra'\'' AND paidUpCapital > 5000000",
"type": "company",
"page": 1,
"limit": 10
}'
import requests
response = requests.post(
"https://api.finscreener.in/api/screener/search",
headers={"Authorization": f"Bearer {token}"},
json={
"query": "State == 'Maharashtra' AND paidUpCapital > 5000000",
"type": "company",
"page": 1,
"limit": 10
}
)
results = response.json()
const response = await fetch('https://api.finscreener.in/api/screener/search', {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
query: "State == 'Maharashtra' AND paidUpCapital > 5000000",
type: 'company',
page: 1,
limit: 10
})
});
const results = await response.json();
{
"results": [
{
"CIN": "L17110MH1973PLC019786",
"companyName": "RELIANCE INDUSTRIES LIMITED",
"State": "Maharashtra",
"City": "Mumbai",
"paidUpCapital": 6766000000,
"llpStatus": "Active"
}
],
"total": 1523,
"page": 1,
"pages": 153
}
{
"results": [
{
"GSTIN": "27AAACR5055K1ZZ",
"TradeName": "RELIANCE INDUSTRIES LIMITED",
"state": "Maharashtra",
"Status": "Active",
"TaxpayerType": "Regular"
}
],
"total": 892,
"page": 1,
"pages": 90
}