# इनवॉइस की सूची

## अनुरोध

```bash
curl -X POST https://api.bitsby.app/invoices/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "startDate=2000-01-01" \
	-F "endDate=2030-01-01" \
	-F "offset=0" \
	-F "limit=10"
```

## अनुरोध पैरामीटर

| पैरामीटर    | डेटा टाइप | विवरण                                                     | उदाहरण                              | अनिवार्य? | डिफ़ॉल्ट |
| ------------ | --------- | --------------------------------------------------------------- | ------------------------------------ | --------- | ------- |
| `invoiceId`  | UUID      | UUID फ़ॉर्मैट में इनवॉइस ID                                       | 1c48b092-9878-48f5-b441-07a8a48e7b54 | नहीं        |         |
| `invoiceUid` | String    | इनवॉइस ID (ग्राहक के लिए)                                   | F7ncQviM1N92                         | नहीं        |         |
| `projectId`  | UUID      | UUID फ़ॉर्मैट में प्रोजेक्ट ID                                       | 1c48b092-9878-48f5-b441-07a8a48e7b54 | नहीं        |         |
| `startDate`  | String    | इनवॉइस बनने की शुरुआती तारीख़, Y-m-d फ़ॉर्मैट में                 | 2000-01-01                           | नहीं        |         |
| `endDate`    | String    | इनवॉइस बनने की आख़िरी तारीख़, Y-m-d फ़ॉर्मैट में                   | 2030-01-01                           | नहीं        |         |
| `status`     | String    | इनवॉइस की स्थिति। मान्य मान: unpaid, canceled, paid, expired | paid                                 | नहीं        |         |
| `offset`     | Integer   | लौटाए जाने वाले पहले रिकॉर्ड का इंडेक्स                             | 0                                    | नहीं        | 0       |
| `limit`      | Integer   | कितने रिकॉर्ड चाहिए, उनकी संख्या                           | 50                                   | नहीं        | 10      |

## जवाब का उदाहरण

```json
{
    "result": "success",
    "data": [
        {
            "id": "59302b02-d1be-4e10-960f-d6ec24bfcaaf",
            "uid": "F7nYgvxM1N92",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime": "2024-02-29 10:49:56",
            "timeToPayDatetime": "2024-02-29 22:49:56",
            "commissionFiatUSD": 1,
            "amountFiatUSD": 100,
            "amountFiat": 100,
            "currencyFiat": "USD",
            "description": null,
            "serviceData": null,
            "views": 0,
            "status": "canceled"
        },
        {
            "id": "f31c61f6-407f-4999-95cf-56477eff06d4",
            "uid": "riUZBnNvd2rX",
            "projectId": "9deea1e2-0c08-41a3-bdc2-a34eada3892d",
            "createDatetime": "2024-02-27 20:57:23",
            "timeToPayDatetime": "2024-02-28 08:57:23",
            "commissionFiatUSD": 0.12,
            "amountFiatUSD": 12,
            "amountFiat": 12,
            "currencyFiat": "USD",
            "description": null,
            "serviceData": "orderId:2444",
            "views": 3,
            "status": "paid",
            "payment": {
                "id": "f986ad8d-2298-473d-982a-efbc817b975d",
                "amount": 12,
                "hash": "f09352627039c088688806821b864895ff237558612d834861621fc026de5f68",
                "transactionDatetime": "2024-02-27 21:05:36"
            },
            "wallet": {
                "id": "47aa71e2-07a0-482e-9172-7114d7376ba0",
                "name": "usdt-tron",
                "blockchain": "tron",
                "cryptocurrency": "usdt",
                "address": "TKbstUwMzLrfTAGL4erYb7gc7ghmHQ9zG7"
            }
        }
    ]
}
```

## जवाब पैरामीटर

| पैरामीटर                     | विवरण                                                                                                                                                                                                                                                                              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                          | UUID फ़ॉर्मैट में इनवॉइस ID                                                                                                                                                                                                                                                                |
| `uid`                         | इनवॉइस ID (ग्राहक के लिए)                                                                                                                                                                                                                                                            |
| `projectId`                   | UUID फ़ॉर्मैट में प्रोजेक्ट ID                                                                                                                                                                                                                                                                |
| `createDatetime`              | इनवॉइस बनने की तारीख़ और समय (UTC)                                                                                                                                                                                                                                                     |
| `timeToPayDatetime`           | वह तारीख़ और समय, जब तक इनवॉइस मान्य है (UTC)। ग्राहक को इस समय से पहले इनवॉइस का भुगतान करना होता है                                                                                                                                                                                 |
| `commissionFiatUSD`           | सेवा शुल्क की राशि। इसकी गणना `amountFiatUSD` राशि से होती है                                                                                                                                                                                                                           |
| `amountFiatUSD`               | USD में बदली इनवॉइस की राशि। इनवॉइस बनाते समय इसकी गणना `amountFiat` से मौजूदा विनिमय दर पर होती है। भुगतान के समय इसमें असल में मिली राशि लिख दी जाती है, जो उस पल की विनिमय दर पर USD में बदली जाती है। `commissionFiatUSD` का शुल्क भी इसी से दोबारा गिना जाता है |
| `amountFiat`                  | फ़िएट मुद्रा में इनवॉइस की मूल राशि। नहीं बदलती                                                                                                                                                                                                                                            |
| `currencyFiat`                | फ़िएट मुद्रा                                                                                                                                                                                                                                                                            |
| `description`                 | इनवॉइस बनाते समय सेट किया गया विवरण। ग्राहक को दिखता है                                                                                                                                                                                                                           |
| `serviceData`                 | इनवॉइस बनाते समय सेट किया गया सर्विस डेटा। ग्राहक को नहीं दिखता। व्यापारी के स्टोर में इनवॉइस और भुगतान की पहचान के लिए इस्तेमाल होता है                                                                                                                                                    |
| `views`                       | भुगतान पृष्ठ के व्यू की संख्या                                                                                                                                                                                                                                                             |
| `status`                      | इनवॉइस की स्थिति                                                                                                                                                                                                                                                                           |
| `payment`                     | भुगतान के पैरामीटर वाला ब्लॉक। तब होता है, जब इनवॉइस का भुगतान हुआ हो                                                                                                                                                                                                                       |
| `payment.id`                  | UUID फ़ॉर्मैट में भुगतान ID                                                                                                                                                                                                                                                                |
| `payment.amount`              | क्रिप्टोकरेंसी में भुगतान की राशि                                                                                                                                                                                                                                                         |
| `payment.hash`                | ऑन-चेन ट्रांज़ैक्शन का hash                                                                                                                                                                                                                                                          |
| `payment.transactionDatetime` | ऑन-चेन ट्रांज़ैक्शन की तारीख़ और समय (UTC)                                                                                                                                                                                                                                          |
| `wallet`                      | उस वॉलेट के पैरामीटर वाला ब्लॉक, जिस पर भुगतान आया। तब होता है, जब इनवॉइस का भुगतान हुआ हो                                                                                                                                                                                       |
| `wallet.id`                   | UUID फ़ॉर्मैट में वॉलेट ID                                                                                                                                                                                                                                                                 |
| `wallet.name`                 | वॉलेट का नाम                                                                                                                                                                                                                                                                              |
| `wallet.blockchain`           | क्रिप्टो वॉलेट का ब्लॉकचेन                                                                                                                                                                                                                                                           |
| `wallet.cryptocurrency`       | वॉलेट की क्रिप्टोकरेंसी                                                                                                                                                                                                                                                              |
| `wallet.address`              | क्रिप्टो वॉलेट का एड्रेस                                                                                                                                                                                                                                                                 |