Fetch eBRC Details

Fetch eBRC details

curl --request POST \
  --url https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "platformCustomerId": "ee849a90-7a28-49b4-8cb2-8e31041650a2",
  "iecCode": "0123456789",
  "eBRCIssueFromDt": "01012025",
  "eBRCIssueToDt": "01072026"
}
'

import requests

url = "https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details"

payload = {
    "platformCustomerId": "ee849a90-7a28-49b4-8cb2-8e31041650a2",
    "iecCode": "0123456789",
    "eBRCIssueFromDt": "01012025",
    "eBRCIssueToDt": "01072026"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    platformCustomerId: 'ee849a90-7a28-49b4-8cb2-8e31041650a2',
    iecCode: '0123456789',
    eBRCIssueFromDt: '01012025',
    eBRCIssueToDt: '01072026'
  })
};

fetch('https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'platformCustomerId' => 'ee849a90-7a28-49b4-8cb2-8e31041650a2',
    'iecCode' => '0123456789',
    'eBRCIssueFromDt' => '01012025',
    'eBRCIssueToDt' => '01072026'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details"

	payload := strings.NewReader("{\n  \"platformCustomerId\": \"ee849a90-7a28-49b4-8cb2-8e31041650a2\",\n  \"iecCode\": \"0123456789\",\n  \"eBRCIssueFromDt\": \"01012025\",\n  \"eBRCIssueToDt\": \"01072026\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platformCustomerId\": \"ee849a90-7a28-49b4-8cb2-8e31041650a2\",\n  \"iecCode\": \"0123456789\",\n  \"eBRCIssueFromDt\": \"01012025\",\n  \"eBRCIssueToDt\": \"01072026\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"platformCustomerId\": \"ee849a90-7a28-49b4-8cb2-8e31041650a2\",\n  \"iecCode\": \"0123456789\",\n  \"eBRCIssueFromDt\": \"01012025\",\n  \"eBRCIssueToDt\": \"01072026\"\n}"

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

[
  {
    "iec": "<string>",
    "eBRCNumber": "<string>",
    "eBRCDate": "<string>",
    "eBRCStatus": "<string>",
    "billNo": "<string>",
    "sbCumInvoiceNumber": "<string>",
    "sbCumInvoiceDate": "<string>",
    "realisedValueFCC": 123,
    "currencyCode": "<string>",
    "realizationDt": "<string>",
    "brcUtilStatus": "<string>",
    "isGstAvailed": "<string>",
    "gstin": "<string>",
    "gstInvoiceNo": "<string>",
    "gstInvoiceDate": "<string>"
  }
]

{
  "code": "<string>",
  "message": "<string>"
}

POST

genebrc

fetch-details

Fetch eBRC details

curl --request POST \
  --url https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "platformCustomerId": "ee849a90-7a28-49b4-8cb2-8e31041650a2",
  "iecCode": "0123456789",
  "eBRCIssueFromDt": "01012025",
  "eBRCIssueToDt": "01072026"
}
'

import requests

url = "https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details"

payload = {
    "platformCustomerId": "ee849a90-7a28-49b4-8cb2-8e31041650a2",
    "iecCode": "0123456789",
    "eBRCIssueFromDt": "01012025",
    "eBRCIssueToDt": "01072026"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    platformCustomerId: 'ee849a90-7a28-49b4-8cb2-8e31041650a2',
    iecCode: '0123456789',
    eBRCIssueFromDt: '01012025',
    eBRCIssueToDt: '01072026'
  })
};

fetch('https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'platformCustomerId' => 'ee849a90-7a28-49b4-8cb2-8e31041650a2',
    'iecCode' => '0123456789',
    'eBRCIssueFromDt' => '01012025',
    'eBRCIssueToDt' => '01072026'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details"

	payload := strings.NewReader("{\n  \"platformCustomerId\": \"ee849a90-7a28-49b4-8cb2-8e31041650a2\",\n  \"iecCode\": \"0123456789\",\n  \"eBRCIssueFromDt\": \"01012025\",\n  \"eBRCIssueToDt\": \"01072026\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platformCustomerId\": \"ee849a90-7a28-49b4-8cb2-8e31041650a2\",\n  \"iecCode\": \"0123456789\",\n  \"eBRCIssueFromDt\": \"01012025\",\n  \"eBRCIssueToDt\": \"01072026\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ebrcapi.eximfiles.io/api/v1/genebrc/fetch-details")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"platformCustomerId\": \"ee849a90-7a28-49b4-8cb2-8e31041650a2\",\n  \"iecCode\": \"0123456789\",\n  \"eBRCIssueFromDt\": \"01012025\",\n  \"eBRCIssueToDt\": \"01072026\"\n}"

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

[
  {
    "iec": "<string>",
    "eBRCNumber": "<string>",
    "eBRCDate": "<string>",
    "eBRCStatus": "<string>",
    "billNo": "<string>",
    "sbCumInvoiceNumber": "<string>",
    "sbCumInvoiceDate": "<string>",
    "realisedValueFCC": 123,
    "currencyCode": "<string>",
    "realizationDt": "<string>",
    "brcUtilStatus": "<string>",
    "isGstAvailed": "<string>",
    "gstin": "<string>",
    "gstInvoiceNo": "<string>",
    "gstInvoiceDate": "<string>"
  }
]

{
  "code": "<string>",
  "message": "<string>"
}

Fetch eBRC details for a platform customer over an issue-date range. Results are fetched live and saved to your account. Use this after a request reaches Processed to pull the certificate metadata into your system. Limited to 10 calls per minute.

Request body example

{
  "platformCustomerId": "ee849a90-7a28-49b4-8cb2-8e31041650a2",
  "iecCode": "0123456789",
  "eBRCIssueFromDt": "01012026",
  "eBRCIssueToDt": "01072026",
  "sbCumInvoiceNumber": null,
  "sbCumInvoiceDate": null
}

Field notes

Field	Required	Description
`platformCustomerId`	Yes	Platform customer UUID
`iecCode`	Yes	IEC code linked to the customer’s DGFT credentials
`eBRCIssueFromDt`	Yes	Start of eBRC issue date range (`DDMMYYYY`)
`eBRCIssueToDt`	Yes	End of eBRC issue date range (`DDMMYYYY`)
`sbCumInvoiceNumber`	No	Filter by shipping bill cum invoice number
`sbCumInvoiceDate`	No	Filter by shipping bill cum invoice date (`DDMMYYYY`)

Response example

An array of certificates in the data field:

{
  "success": true,
  "data": [
    {
      "iec": "0123456789",
      "eBRCNumber": "EBRC0000012345",
      "eBRCDate": "01042026",
      "eBRCStatus": "Issued",
      "billNo": "EXP-2024-0042",
      "sbCumInvoiceNumber": "SB7654321",
      "sbCumInvoiceDate": "15032026",
      "realisedValueFCC": 25000,
      "currencyCode": "USD",
      "realizationDt": "01042026"
    }
  ],
  "statusCode": 200,
  "timestamp": "2026-07-22T12:50:00.000Z"
}

Errors

422 / 409 for DGFT credential problems. See DGFT credential error codes.
429 beyond 10 calls per minute. See rate limits.

Next steps

Download the certificate PDF with the eBRCNumber.
Get Request Status if a request is still processing.
Currency Codes for currencyCode values.

Authorizations

x-api-key

string

header

required

Body

application/json

platformCustomerId

string

required

Platform customer UUID

iecCode

string

required

IEC code

eBRCIssueFromDt

string

required

Start of eBRC issue date range (DDMMYYYY)

eBRCIssueToDt

string

required

End of eBRC issue date range (DDMMYYYY)

sbCumInvoiceNumber

string | null

Optional filter by shipping bill cum invoice number

sbCumInvoiceDate

string | null

Optional filter by shipping bill cum invoice date (DDMMYYYY)

Response

eBRC details from DGFT

iec

string

eBRCNumber

string

eBRCDate

string

eBRCStatus

string

billNo

string

sbCumInvoiceNumber

string

sbCumInvoiceDate

string

realisedValueFCC

number

currencyCode

string

realizationDt

string

brcUtilStatus

string

isGstAvailed

string

gstin

string

gstInvoiceNo

string

gstInvoiceDate

string

List Generation Requests Download eBRC PDF

⌘I

​Request body example

​Field notes

​Response example

​Errors

​Next steps

Authorizations

Body

Response

Request body example

Field notes

Response example

Errors

Next steps