> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ebrc.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch eBRC Details

> Fetch generated eBRC details for a platform customer over an issue-date range, including certificate numbers, dates, realised values, and status.

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

```json theme={"dark"}
{
  "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:

```json theme={"dark"}
{
  "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](/errors#dgft-credential-error-codes).
* `429` beyond 10 calls per minute. See [rate limits](/authentication#rate-limits).

### Next steps

* [Download the certificate PDF](/api-reference/genebrc/download) with the `eBRCNumber`.
* [Get Request Status](/api-reference/genebrc/status) if a request is still processing.
* [Currency Codes](/annexure/currency-codes) for `currencyCode` values.


## OpenAPI

````yaml POST /genebrc/fetch-details
openapi: 3.1.0
info:
  title: eBRC API
  description: >-
    REST API for generating and managing electronic Bank Realization
    Certificates (eBRC) through DGFT's GenEBRC module. Onboard exporters,
    validate their DGFT credentials, pull inward remittance (IRM) data, submit
    certificate generation requests singly or in bulk, and track them to
    completion. All JSON responses are wrapped in the standard envelope {
    success, data, statusCode, timestamp }; the schemas on each endpoint
    describe the data field.
  contact:
    name: Eximfiles support
    email: amin@eximfiles.io
  version: 1.0.0
servers:
  - url: https://ebrcapi.eximfiles.io/api/v1
    description: Production
  - url: https://ebrcapi.dev.eximfiles.com/api/v1
    description: Sandbox
security:
  - x-api-key: []
paths:
  /genebrc/fetch-details:
    post:
      summary: Fetch eBRC details
      description: >-
        Fetch eBRC details from DGFT for a platform customer over an issue-date
        range.
      operationId: fetchEbrcDetails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FetchEBRCDetailsRequest'
            examples:
              default:
                summary: Fetch eBRC details example
                value:
                  platformCustomerId: ee849a90-7a28-49b4-8cb2-8e31041650a2
                  iecCode: '0123456789'
                  eBRCIssueFromDt: '01012025'
                  eBRCIssueToDt: '01072026'
                  sbCumInvoiceNumber: null
                  sbCumInvoiceDate: null
      responses:
        '200':
          description: eBRC details from DGFT
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/FetchEBRCDetailsResponse'
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FetchEBRCDetailsRequest:
      type: object
      properties:
        platformCustomerId:
          type: string
          description: Platform customer UUID
        iecCode:
          type: string
          description: IEC code
        eBRCIssueFromDt:
          type: string
          description: Start of eBRC issue date range (DDMMYYYY)
        eBRCIssueToDt:
          type: string
          description: End of eBRC issue date range (DDMMYYYY)
        sbCumInvoiceNumber:
          type: string
          nullable: true
          description: Optional filter by shipping bill cum invoice number
        sbCumInvoiceDate:
          type: string
          nullable: true
          description: Optional filter by shipping bill cum invoice date (DDMMYYYY)
      required:
        - platformCustomerId
        - iecCode
        - eBRCIssueFromDt
        - eBRCIssueToDt
    FetchEBRCDetailsResponse:
      type: object
      properties:
        iec:
          type: string
        eBRCNumber:
          type: string
        eBRCDate:
          type: string
        eBRCStatus:
          type: string
        billNo:
          type: string
        sbCumInvoiceNumber:
          type: string
        sbCumInvoiceDate:
          type: string
        realisedValueFCC:
          type: number
        currencyCode:
          type: string
        realizationDt:
          type: string
        brcUtilStatus:
          type: string
        isGstAvailed:
          type: string
        gstin:
          type: string
        gstInvoiceNo:
          type: string
        gstInvoiceDate:
          type: string
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    x-api-key:
      type: apiKey
      name: x-api-key
      in: header

````