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

# Orders Guide

> Order detailed company and GST contact data

## Overview

Finscreener allows you to order detailed contact information for companies, directors, and GST registrations. This data includes emails, phone numbers, and other contact details not available in basic search results.

## Order Types

### Normal Order

Order data for individual entities:

* Single company
* Single director
* Single GST registration

### Bulk Order

Order data for multiple entities at once by uploading a list of identifiers.

## Pricing

| Item Type | Credits | Description                      |
| --------- | ------- | -------------------------------- |
| Company   | 1       | Company contact details          |
| Director  | 1       | Director contact details         |
| GST       | 1       | GST registration contact details |

<Note>
  **No contact, no charge.** If an ordered item has no contact details available, the credit for that item is automatically refunded to your balance. You are only charged for items where contact data is found.
</Note>

## Creating an Order

<Steps>
  <Step title="Select Items">
    Add companies, directors, or GST registrations to your cart from search results or detail pages.
  </Step>

  <Step title="Review Cart">
    Review selected items and total credits required.
  </Step>

  <Step title="Confirm Payment">
    Choose to pay with credits or complete a one-time payment.
  </Step>

  <Step title="Download Data">
    Once processed, download your order data in JSON or CSV format.
  </Step>
</Steps>

## Order Status

| Status     | Description                         |
| ---------- | ----------------------------------- |
| Pending    | Order received, awaiting processing |
| Processing | Order is being processed            |
| Completed  | Order ready for download            |
| Failed     | Processing failed (contact support) |
| Cancelled  | Order was cancelled                 |

## Tracking Orders

Navigate to **Order Track** to view all your orders:

* View order history
* Check order status
* Download completed orders
* Export order data

## API Usage

Create orders programmatically:

```bash theme={null}
curl -X POST https://api.finscreener.in/api/orders/normal \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "type": "company",
        "name": "Example Pvt Ltd",
        "number": "U12345MH2024PTC123456",
        "price": 1
      }
    ],
    "orderName": "My Order",
    "paymentOption": "credits"
  }'
```

## Best Practices

<CardGroup cols={2}>
  <Card title="Bulk for Scale" icon="layer-group">
    Use bulk orders when processing many entities to save time.
  </Card>

  <Card title="Check Credits" icon="coins">
    Monitor your credit balance before placing large orders.
  </Card>

  <Card title="Only Pay for Hits" icon="rotate-left">
    Items with no contact details are automatically refunded, so you only spend credits on data you receive.
  </Card>

  <Card title="Export Formats" icon="file-export">
    Choose CSV for spreadsheet analysis, JSON for programmatic use.
  </Card>
</CardGroup>