curl -X POST "https://api.finscreener.in/api/recently-registered/directors" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from_date": "2026-07-01",
"to_date": "2026-07-18",
"state": "Karnataka"
}'
{
"data": [
{
"DIN": "09876543",
"firstName": "ANANYA",
"middleName": null,
"lastName": "SHARMA",
"fullName": "ANANYA SHARMA",
"DINApprovalDate": "2026-07-11T00:00:00",
"DINStatus": "Approved",
"directorDisqualified": "No",
"district": "Bengaluru Urban",
"state": "Karnataka",
"postalCode": "560034",
"country": "India"
}
],
"total": 642,
"page": 1,
"limit": 10,
"access": {
"granted_by": "subscription",
"territory": {
"restricted": true,
"states": ["Karnataka"],
"districts": null,
"pincodes": null
},
"date_window": {
"from": "2026-07-07",
"to": "2026-07-18",
"anchored_to_subscription": true
}
}
}
{
"error_code": "NO_DATASET_ACCESS",
"dataset": "recently_registered.director",
"message": "This API key has no access to recently registered DIRECTOR data. See GET /api/access.",
"reason": "no_active_plan_grants_this_dataset"
}
Recently Registered
Recent Directors
Get recently registered directors
POST
/
api
/
recently-registered
/
directors
curl -X POST "https://api.finscreener.in/api/recently-registered/directors" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from_date": "2026-07-01",
"to_date": "2026-07-18",
"state": "Karnataka"
}'
{
"data": [
{
"DIN": "09876543",
"firstName": "ANANYA",
"middleName": null,
"lastName": "SHARMA",
"fullName": "ANANYA SHARMA",
"DINApprovalDate": "2026-07-11T00:00:00",
"DINStatus": "Approved",
"directorDisqualified": "No",
"district": "Bengaluru Urban",
"state": "Karnataka",
"postalCode": "560034",
"country": "India"
}
],
"total": 642,
"page": 1,
"limit": 10,
"access": {
"granted_by": "subscription",
"territory": {
"restricted": true,
"states": ["Karnataka"],
"districts": null,
"pincodes": null
},
"date_window": {
"from": "2026-07-07",
"to": "2026-07-18",
"anchored_to_subscription": true
}
}
}
{
"error_code": "NO_DATASET_ACCESS",
"dataset": "recently_registered.director",
"message": "This API key has no access to recently registered DIRECTOR data. See GET /api/access.",
"reason": "no_active_plan_grants_this_dataset"
}
Retrieve director (DIN) registrations within a specified date range.
Requires an entitlement for the
recently_registered.director dataset. Call
GET /api/access to see whether it is enabled, and the exact
territory and date window that will be applied.This endpoint enforces your entitlement. Requests are restricted to the states,
districts and pincodes on your plan, and to your subscription-anchored date window.
With no entitlement the request is refused with
403 NO_DATASET_ACCESS.Headers
string
required
Bearer token:
Bearer <access_token>Request Body
Send filter criteria as a JSON body. All fields are optional.string
Start date (YYYY-MM-DD). Clamped to the start of your entitled date window.
string
End date (YYYY-MM-DD)
string
Search term (DIN, director name)
string
Filter by state. Must fall within your entitled territory.
string
Filter by district. Comma-separated for multiple values.
string
Filter by pincode. Comma-separated for multiple values.
string
Filter by status
string
Filter by business type
number
default:"1"
Page number
number
default:"10"
Results per page
Response
array
The matching director registrations.
number
Total number of matching records within your entitled scope.
number
Current page.
number
Page size.
object
curl -X POST "https://api.finscreener.in/api/recently-registered/directors" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"from_date": "2026-07-01",
"to_date": "2026-07-18",
"state": "Karnataka"
}'
{
"data": [
{
"DIN": "09876543",
"firstName": "ANANYA",
"middleName": null,
"lastName": "SHARMA",
"fullName": "ANANYA SHARMA",
"DINApprovalDate": "2026-07-11T00:00:00",
"DINStatus": "Approved",
"directorDisqualified": "No",
"district": "Bengaluru Urban",
"state": "Karnataka",
"postalCode": "560034",
"country": "India"
}
],
"total": 642,
"page": 1,
"limit": 10,
"access": {
"granted_by": "subscription",
"territory": {
"restricted": true,
"states": ["Karnataka"],
"districts": null,
"pincodes": null
},
"date_window": {
"from": "2026-07-07",
"to": "2026-07-18",
"anchored_to_subscription": true
}
}
}
{
"error_code": "NO_DATASET_ACCESS",
"dataset": "recently_registered.director",
"message": "This API key has no access to recently registered DIRECTOR data. See GET /api/access.",
"reason": "no_active_plan_grants_this_dataset"
}