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

# Create Order

> Create a new data order

Create an order to purchase detailed data for companies, directors, or GST registrations.

## Headers

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

## Request Body

<ParamField body="orderName" type="string" required>
  Order name/description
</ParamField>

<ParamField body="paymentOption" type="string" required>
  Payment method: `credits` or `cashfree`
</ParamField>

<ParamField body="items" type="array" required>
  Array of items to order

  <Expandable title="item properties">
    <ParamField body="type" type="string" required>
      Item type: `company`, `director`, or `gst`
    </ParamField>

    <ParamField body="name" type="string" required>
      Entity name
    </ParamField>

    <ParamField body="number" type="string" required>
      Identifier (CIN, DIN, or GSTIN)
    </ParamField>
  </Expandable>
</ParamField>

## Pricing

| Type     | Credits |
| -------- | ------- |
| company  | 1       |
| director | 1       |
| gst      | 1       |

<Note>
  If an ordered item has no contact details available, the credit for that item is automatically refunded to your balance.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  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"
        }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "_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"
  }
  ```
</ResponseExample>