> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://open-api-docs.dice.tech/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://open-api-docs.dice.tech/_mcp/server.

# Fetch Debit Note Details

GET https://heimdall.eka.io/apis/external/vendor/debitNote/{id}/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2

### API Endpoint: Get Debit Note Details

This endpoint retrieves detailed information about a specific debit note identified by its unique ID. It provides comprehensive data related to the debit note, including associated vendor, invoice, tax information, and itemized details.

#### Request Format

* **Method**: GET

* **URL**: `{{host}}/apis/external/vendor/debitNote/:id/getDebitNoteDetails`

* **Path Parameter**:

  * `id` (required): The unique identifier of the debit note for which details are to be fetched.

#### Response Structure

The response is a JSON object containing the following fields:

* **id**: Unique identifier for the debit note.

* **debitNoteId**: Identifier of the debit note.

* **billNo**: Bill number associated with the debit note.

* **date**: Date of the debit note.

* **createdAt**: Timestamp of when the debit note was created.

* **updatedAt**: Timestamp of the last update to the debit note.

* **amount**: Total amount of the debit note.

* **currencyAmount**: Amount in the specified currency.

* **currency**: Currency type.

* **stage**: Current stage of the debit note.

* **status**: Current status of the debit note.

* **service**: Service associated with the debit note.

* **category**: Category of the debit note.

* **categoryId**: Identifier for the category.

* **owner**: Object containing details about the owner of the debit note (id, type, name).

* **invoice**: Object containing details about the associated invoice (id, invoiceId, amount, currencyAmount, status, dates, owner).

* **vendor**: Object containing vendor information (id, registeredId, name, tradeName, PAN).

* **officeData**: Information about the office related to the debit note.

* **shipToData**: Information about the shipping details.

* **name**: Name associated with the debit note.

* **poId**: Purchase order ID linked to the debit note.

* **tag**: Tags associated with the debit note.

* **fraud**: Boolean indicating if the debit note is flagged for fraud.

* **duplicates**: Array of potential duplicate identifiers.

* **taxInfo**: Object containing detailed tax information (GST, TDS, amounts).

* **config**: Configuration details including files, comments, and items related to the debit note.

* **data**: Additional data related to the debit note.

* **timelines**: Array of timeline events related to the debit note.

* **items**: Array of items associated with the debit note, each containing detailed attributes such as id, productId, name, price, quantity, tax details, and more.

This endpoint is essential for retrieving comprehensive details of a debit note, which can be used for auditing, reporting, or further processing.

Reference: https://open-api-docs.dice.tech/dice-standardized-ap-is-v-2-copy/debit-note/fetch-debit-note-details

## Servers

- `https://heimdall.eka.io` (https://heimdall.eka.io, default)
- `https://heimdall.eka.ioapis` (https://heimdall.eka.ioapis)

## Request

### Path parameters

- `id` (string, required) — Dice id, uniquely identifying a Credit Note stored in DB

### Headers

- `DICE-APP-ID` (string, optional)
- `X-CLIENT-ID` (string, optional)
- `X-CLIENT-SECRET` (string, optional)

## Response

### 200

OK

- `id` (integer, required)
- `debitNoteId` (string, required)
- `billNo` (string, required)
- `date` (integer, required)
- `createdAt` (integer, required)
- `updatedAt` (integer, required)
- `amount` (integer, required)
- `currencyAmount` (integer, required)
- `currency` (string, required)
- `stage` (string, required)
- `status` (string, required)
- `service` (string, required)
- `category` (string, required)
- `categoryId` (integer, required)
- `owner` (object, required)
  - `id` (integer, required)
  - `ownerType` (string, required)
  - `ownerId` (string, required)
  - `ownerName` (string, required)
- `invoice` (object, required)
  - `id` (integer, required)
  - `invoiceId` (string, required)
  - `amount` (integer, required)
  - `currencyAmount` (integer, required)
  - `owner` (object, required)
    - `id` (integer, required)
    - `ownerType` (string, required)
    - `ownerId` (string, required)
    - `ownerName` (string, required)
  - `status` (string, required)
  - `date` (integer, required)
  - `dueDate` (integer, required)
  - `createdAt` (integer, required)
- `vendor` (object, required)
  - `id` (integer, required)
  - `registeredId` (string, required)
  - `name` (string, required)
  - `tradeName` (string, required)
  - `pan` (string, required)
  - `rcVendor` (boolean, required)
- `officeData` (object, required)
  - `id` (integer, required)
  - `name` (string, required)
- `shipToData` (object, required)
  - `id` (integer, required)
  - `name` (string, required)
- `name` (string, required)
- `poId` (integer, required)
- `tag` (string, required)
- `fraud` (boolean, required)
- `duplicates` (list of string, required)
- `taxInfo` (object, required)
  - `render` (string, required)
  - `currency` (string, required)
  - `gst` (integer, required)
  - `vendorGstin` (string, required)
  - `igst` (integer, required)
  - `utgst` (integer, required)
  - `sgst` (integer, required)
  - `discount` (integer, required)
  - `discountAmount` (integer, required)
  - `cgst` (integer, required)
  - `taxId` (integer, required)
  - `tds` (integer, required)
  - `tdsSlab` (integer, required)
  - `cessAmount` (integer, required)
  - `baseAmount` (integer, required)
  - `grossAmount` (integer, required)
  - `roundOff` (integer, required)
  - `total` (integer, required)
  - `paidAmount` (integer, required)
  - `sameState` (boolean, required)
- `config` (object, required)
  - `files` (list of any, required)
  - `comments` (list of any, required)
  - `items` (list of object, required)
    - `id` (string, required)
    - `referenceId` (integer, required)
    - `productId` (integer, required)
    - `name` (string, required)
    - `price` (integer, required)
    - `qtty` (integer, required)
    - `taxSlab` (integer, required)
    - `tax` (integer, required)
    - `base` (integer, required)
    - `hsn` (string, required)
    - `unit` (string, required)
    - `tds` (boolean, required)
    - `isTds` (boolean, required)
    - `glCode` (string, required)
    - `notes` (string, required)
    - `discount` (integer, required)
    - `service` (string, required)
    - `currency` (string, required)
    - `cessAmount` (integer, required)
    - `cessPercent` (integer, required)
    - `amount` (integer, required)
    - `grossBase` (integer, required)
    - `grnQty` (integer, required)
    - `grnNos` (list of any, required)
    - `debitQty` (integer, required)
    - `gstNonCreditable` (boolean, required)
    - `data` (list of any, required)
    - `attrs` (object, required)
    - `costAllocations` (list of any, required)
    - `grnQtyMapping` (object, required)
    - `comments` (list of any, required)
  - `penalty` (integer, required)
- `data` (list of any, required)
- `timelines` (list of object, required)
  - `id` (string, required)
  - `email` (string, required)
  - `type` (string, required)
  - `name` (string, required)
  - `time` (integer, required)
  - `actionTime` (integer, required)
  - `data` (list of any, required)
- `items` (list of object, required)
  - `id` (string, required)
  - `referenceId` (integer, required)
  - `productId` (integer, required)
  - `name` (string, required)
  - `price` (integer, required)
  - `qtty` (integer, required)
  - `taxSlab` (integer, required)
  - `tax` (integer, required)
  - `base` (integer, required)
  - `hsn` (string, required)
  - `unit` (string, required)
  - `tds` (boolean, required)
  - `isTds` (boolean, required)
  - `glCode` (string, required)
  - `notes` (string, required)
  - `discount` (integer, required)
  - `service` (string, required)
  - `currency` (string, required)
  - `cessAmount` (integer, required)
  - `cessPercent` (integer, required)
  - `amount` (integer, required)
  - `grossBase` (integer, required)
  - `grnQty` (integer, required)
  - `grnNos` (list of any, required)
  - `debitQty` (integer, required)
  - `gstNonCreditable` (boolean, required)
  - `data` (list of any, required)
  - `attrs` (object, required)
  - `costAllocations` (list of any, required)
  - `grnQtyMapping` (object, required)
  - `comments` (list of any, required)

## Examples

**Response**

```json
{
  "id": 100,
  "debitNoteId": "DN-INDIAN-000000012",
  "billNo": "14",
  "date": 1707417000000,
  "createdAt": 1707464911844,
  "updatedAt": 1707464911864,
  "amount": 12,
  "currencyAmount": 12,
  "currency": "INR",
  "stage": "start",
  "status": "COMPLETED",
  "service": "karan",
  "category": "karan",
  "categoryId": 129,
  "owner": {
    "id": 118,
    "ownerType": "ADMIN",
    "ownerId": "118",
    "ownerName": "Admin"
  },
  "invoice": {
    "id": 469434,
    "invoiceId": "VI-INDIAN-000001958",
    "amount": 133,
    "currencyAmount": 133,
    "owner": {
      "id": 287032,
      "ownerType": "CONTACT",
      "ownerId": "287032",
      "ownerName": "BAKKIREDDY SRINIVASULU REDDY"
    },
    "status": "CREDIT_NOTE_HOLD",
    "date": 1707417000000,
    "dueDate": 1707417000000,
    "createdAt": 1707459075806
  },
  "vendor": {
    "id": 287032,
    "registeredId": "CONTACT-INDIAN-0000063",
    "name": "BAKKIREDDY SRINIVASULU REDDY",
    "tradeName": "TDTRFG",
    "pan": " AFQPA7358J",
    "rcVendor": false
  },
  "officeData": {
    "id": 1347,
    "name": "Pune"
  },
  "shipToData": {
    "id": 1347,
    "name": "Pune"
  },
  "name": "BAKKIREDDY SRINIVASULU REDDY",
  "poId": 54592,
  "tag": "09-02-2024-287032-14",
  "fraud": true,
  "duplicates": [
    "DN-INDIAN-000000010",
    "DN-INDIAN-000000011",
    "DN-INDIAN-000000012"
  ],
  "taxInfo": {
    "render": "INDIA",
    "currency": "INR",
    "gst": 0,
    "vendorGstin": "",
    "igst": 0,
    "utgst": 0,
    "sgst": 0,
    "discount": 0,
    "discountAmount": 0,
    "cgst": 0,
    "taxId": 0,
    "tds": 0,
    "tdsSlab": 0,
    "cessAmount": 0,
    "baseAmount": 12,
    "grossAmount": 12,
    "roundOff": 0,
    "total": 12,
    "paidAmount": 12,
    "sameState": true
  },
  "config": {
    "files": [],
    "comments": [],
    "items": [
      {
        "id": "4c065c89-3df2-4bc3-89de-3e50223a4ba0",
        "referenceId": 157268,
        "productId": 0,
        "name": "Macbook",
        "price": 11,
        "qtty": 1,
        "taxSlab": 0,
        "tax": 0,
        "base": 11,
        "hsn": "hiosp",
        "unit": "pc",
        "tds": true,
        "isTds": true,
        "glCode": "",
        "notes": "",
        "discount": 0,
        "service": "karan",
        "currency": "INR",
        "cessAmount": 0,
        "cessPercent": 0,
        "amount": 11,
        "grossBase": 0,
        "grnQty": 0,
        "grnNos": [],
        "debitQty": 0,
        "gstNonCreditable": false,
        "data": [],
        "attrs": {},
        "costAllocations": [],
        "grnQtyMapping": {},
        "comments": []
      },
      {
        "id": "0b3dcd49-5f67-47fb-ad96-526264330c5e",
        "referenceId": 157269,
        "productId": 0,
        "name": "usd product",
        "price": 1,
        "qtty": 1,
        "taxSlab": 0,
        "tax": 0,
        "base": 1,
        "hsn": "we",
        "unit": "pc",
        "tds": true,
        "isTds": true,
        "glCode": "",
        "notes": "",
        "discount": 0,
        "service": "karan",
        "currency": "INR",
        "cessAmount": 0,
        "cessPercent": 0,
        "amount": 1,
        "grossBase": 0,
        "grnQty": 0,
        "grnNos": [],
        "debitQty": 0,
        "gstNonCreditable": false,
        "data": [],
        "attrs": {},
        "costAllocations": [],
        "grnQtyMapping": {},
        "comments": []
      }
    ],
    "penalty": 0
  },
  "data": [],
  "timelines": [
    {
      "id": "440cb174-fe42-410c-97eb-e97f2f400e4a",
      "email": "App Started",
      "type": "start",
      "name": "Submitted by Admin",
      "time": 1707464911844,
      "actionTime": 1707464911844,
      "data": []
    },
    {
      "id": "440cb174-fe42-410c-97eb-e97f2f400e4a",
      "email": "App completed",
      "type": "Completed",
      "name": "COMPLETED",
      "time": 1707464911864,
      "actionTime": 1707464911864,
      "data": []
    }
  ],
  "items": [
    {
      "id": "4c065c89-3df2-4bc3-89de-3e50223a4ba0",
      "referenceId": 157268,
      "productId": 0,
      "name": "Macbook",
      "price": 11,
      "qtty": 1,
      "taxSlab": 0,
      "tax": 0,
      "base": 11,
      "hsn": "hiosp",
      "unit": "pc",
      "tds": true,
      "isTds": true,
      "glCode": "",
      "notes": "",
      "discount": 0,
      "service": "karan",
      "currency": "INR",
      "cessAmount": 0,
      "cessPercent": 0,
      "amount": 11,
      "grossBase": 0,
      "grnQty": 0,
      "grnNos": [],
      "debitQty": 0,
      "gstNonCreditable": false,
      "data": [],
      "attrs": {},
      "costAllocations": [],
      "grnQtyMapping": {},
      "comments": []
    },
    {
      "id": "0b3dcd49-5f67-47fb-ad96-526264330c5e",
      "referenceId": 157269,
      "productId": 0,
      "name": "usd product",
      "price": 1,
      "qtty": 1,
      "taxSlab": 0,
      "tax": 0,
      "base": 1,
      "hsn": "we",
      "unit": "pc",
      "tds": true,
      "isTds": true,
      "glCode": "",
      "notes": "",
      "discount": 0,
      "service": "karan",
      "currency": "INR",
      "cessAmount": 0,
      "cessPercent": 0,
      "amount": 1,
      "grossBase": 0,
      "grnQty": 0,
      "grnNos": [],
      "debitQty": 0,
      "gstNonCreditable": false,
      "data": [],
      "attrs": {},
      "costAllocations": [],
      "grnQtyMapping": {},
      "comments": []
    }
  ]
}
```

**SDK Code**

```python Debit Note_Fetch Debit Note Details_example
import requests

url = "https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2"

headers = {
    "DICE-APP-ID": "{{Company Code}}",
    "X-CLIENT-ID": "{{API Client ID}}",
    "X-CLIENT-SECRET": "{{API Client Secret}}"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Debit Note_Fetch Debit Note Details_example
const url = 'https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2';
const options = {
  method: 'GET',
  headers: {
    'DICE-APP-ID': '{{Company Code}}',
    'X-CLIENT-ID': '{{API Client ID}}',
    'X-CLIENT-SECRET': '{{API Client Secret}}'
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Debit Note_Fetch Debit Note Details_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("DICE-APP-ID", "{{Company Code}}")
	req.Header.Add("X-CLIENT-ID", "{{API Client ID}}")
	req.Header.Add("X-CLIENT-SECRET", "{{API Client Secret}}")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Debit Note_Fetch Debit Note Details_example
require 'uri'
require 'net/http'

url = URI("https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["DICE-APP-ID"] = '{{Company Code}}'
request["X-CLIENT-ID"] = '{{API Client ID}}'
request["X-CLIENT-SECRET"] = '{{API Client Secret}}'

response = http.request(request)
puts response.read_body
```

```java Debit Note_Fetch Debit Note Details_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2")
  .header("DICE-APP-ID", "{{Company Code}}")
  .header("X-CLIENT-ID", "{{API Client ID}}")
  .header("X-CLIENT-SECRET", "{{API Client Secret}}")
  .asString();
```

```php Debit Note_Fetch Debit Note Details_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2', [
  'headers' => [
    'DICE-APP-ID' => '{{Company Code}}',
    'X-CLIENT-ID' => '{{API Client ID}}',
    'X-CLIENT-SECRET' => '{{API Client Secret}}',
  ],
]);

echo $response->getBody();
```

```csharp Debit Note_Fetch Debit Note Details_example
using RestSharp;

var client = new RestClient("https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2");
var request = new RestRequest(Method.GET);
request.AddHeader("DICE-APP-ID", "{{Company Code}}");
request.AddHeader("X-CLIENT-ID", "{{API Client ID}}");
request.AddHeader("X-CLIENT-SECRET", "{{API Client Secret}}");
IRestResponse response = client.Execute(request);
```

```swift Debit Note_Fetch Debit Note Details_example
import Foundation

let headers = [
  "DICE-APP-ID": "{{Company Code}}",
  "X-CLIENT-ID": "{{API Client ID}}",
  "X-CLIENT-SECRET": "{{API Client Secret}}"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://heimdall.eka.io/apis/external/vendor/debitNote/1011/getDebitNoteDetails#getApisExternalVendorDebitnoteIdGetdebitnotedetails2")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```