curl -X POST "https://api.finscreener.in/api/orders/normal" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"orderName": "IT Companies Data",
"paymentOption": "credits",
"items": [
{
"type": "company",
"name": "TCS Limited",
"number": "U72200MH2004PTC148441"
}
]
}'
{
"_id": "order_456",
"orderName": "IT Companies Data",
"paymentOption": "credits",
"total_amount": 1,
"status": "completed",
"payment_status": "paid",
"items_count": 1,
"created_at": "2026-02-04T12:00:00Z"
}
Orders
Create Order
Create a new data order
POST
/
api
/
orders
/
normal
curl -X POST "https://api.finscreener.in/api/orders/normal" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"orderName": "IT Companies Data",
"paymentOption": "credits",
"items": [
{
"type": "company",
"name": "TCS Limited",
"number": "U72200MH2004PTC148441"
}
]
}'
{
"_id": "order_456",
"orderName": "IT Companies Data",
"paymentOption": "credits",
"total_amount": 1,
"status": "completed",
"payment_status": "paid",
"items_count": 1,
"created_at": "2026-02-04T12:00:00Z"
}
Create an order to purchase detailed data for companies, directors, or GST registrations.
Headers
string
required
Bearer token:
Bearer <access_token>Request Body
string
required
Order name/description
string
required
Payment method:
credits (instant, deducted from your balance) or cashfree (pay
online).The value cashfree is a legacy label retained for backward compatibility — online
payments are processed by Razorpay. Send cashfree to pay online.array
required
Pricing
| Type | Credits |
|---|---|
| company | 1 |
| director | 1 |
| gst | 1 |
If an ordered item has no contact details available, the credit for that item is automatically refunded to your balance.
curl -X POST "https://api.finscreener.in/api/orders/normal" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"orderName": "IT Companies Data",
"paymentOption": "credits",
"items": [
{
"type": "company",
"name": "TCS Limited",
"number": "U72200MH2004PTC148441"
}
]
}'
{
"_id": "order_456",
"orderName": "IT Companies Data",
"paymentOption": "credits",
"total_amount": 1,
"status": "completed",
"payment_status": "paid",
"items_count": 1,
"created_at": "2026-02-04T12:00:00Z"
}