Create Order

Create a new data order

POST /api/orders/normal

cURL

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": "fullcompany",
        "name": "TCS Limited",
        "number": "U72200MH2004PTC148441"
      }
    ]
  }'

Success

{
  "_id": "order_456",
  "orderName": "IT Companies Data",
  "paymentOption": "credits",
  "total_amount": 5,
  "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

Authorization · string · required

Bearer token: Bearer <access_token>

Request Body

orderName · string · required

Order name/description

paymentOption · string · required

Payment method: credits or cashfree

items · array · required

Array of items to order

Show item properties

type · string · required

Item type: company, director, gst, or fullcompany

name · string · required

Entity name

number · string · required

Identifier (CIN, DIN, or GSTIN)

Pricing

Type	Credits
company	1
director	1
gst	1
fullcompany	5

cURL

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": "fullcompany",
        "name": "TCS Limited",
        "number": "U72200MH2004PTC148441"
      }
    ]
  }'

Success

{
  "_id": "order_456",
  "orderName": "IT Companies Data",
  "paymentOption": "credits",
  "total_amount": 5,
  "status": "completed",
  "payment_status": "paid",
  "items_count": 1,
  "created_at": "2026-02-04T12:00:00Z"
}