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

# Get Request Status

> Poll the processing status of a submitted eBRC generation request by requestId. In production, acknowledgement typically arrives within about 2 hours of submission.

Check processing status for a previously submitted generation request, using the `requestId` returned by [Submit IRMs](/api-reference/genebrc/push-irm) or [Bulk Upload](/api-reference/genebrc/bulk-upload).

<Note>
  Available in Production and Sandbox. In Production, acknowledgement typically arrives within about **2 hours**; polling earlier may return an incomplete or unchanged status.
</Note>

### Request body example

```json theme={"dark"}
{
  "platformCustomerId": "ee849a90-7a28-49b4-8cb2-8e31041650a2",
  "requestId": "IEC1234560120240001ABCDE12345"
}
```

### Response example

The per-record results come back in `ebrcBulkGenStatusLst` (field name as returned on the wire):

```json theme={"dark"}
{
  "success": true,
  "data": {
    "dgftAckId": "ACK202404010001",
    "requestId": "IEC1234560120240001ABCDE12345",
    "recordResCount": 1,
    "recordProCount": 1,
    "recordFailCount": 0,
    "processingStatus": "Processed",
    "ebrcBulkGenStatusLst": [
      {
        "serialNo": "1",
        "irmNumber": "IRM0000012345",
        "irmDt": "01042024",
        "iecNumber": "0123456789",
        "sbCumInvoiceNumber": "SB7654321",
        "sbCumInvoiceDate": "15032024",
        "portCode": "INMAA1",
        "eBRCNumber": "EBRC0000012345",
        "billNo": "EXP-2024-0042",
        "eBRCDt": "01042024",
        "fobFCC": 25000,
        "fcc": "USD",
        "processingStatus": "Processed",
        "errorDetails": []
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-07-22T12:40:00.000Z"
}
```

### `processingStatus` values

| Value       | Meaning                               |
| ----------- | ------------------------------------- |
| `Processed` | All records processed successfully    |
| `Errored`   | Processing failed, see `errorDetails` |

Per-record status in `ebrcBulkGenStatusLst[].processingStatus` uses the same values.

### Next steps

* [Fetch eBRC details](/api-reference/genebrc/fetch-details) once processed.
* [Download the certificate PDF](/api-reference/genebrc/download) with the `eBRCNumber`.
* [List generation requests](/api-reference/genebrc/list) to find older request IDs.


## OpenAPI

````yaml POST /genebrc/status
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/status:
    post:
      summary: Get request status
      description: >-
        Get processing status for a submitted generation request. Available in
        Production and Sandbox. In Production, DGFT acknowledges within about 2
        hours of submission.
      operationId: getEbrcRequestStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetRequestStatusRequest'
            examples:
              default:
                summary: Poll a submitted request
                value:
                  platformCustomerId: ee849a90-7a28-49b4-8cb2-8e31041650a2
                  requestId: IEC1234560120240001ABCDE12345
      responses:
        '200':
          description: Request processing status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRequestStatusResponse'
              examples:
                default:
                  summary: Processed request
                  value:
                    dgftAckId: ACK202404010001
                    requestId: IEC1234560120240001ABCDE12345
                    recordResCount: 1
                    recordProCount: 1
                    recordFailCount: 0
                    processingStatus: Processed
                    ebrcBulkGenStatusLst:
                      - serialNo: '1'
                        irmNumber: IRM0000012345
                        irmDt: '01042024'
                        iecNumber: '0123456789'
                        sbCumInvoiceNumber: SB7654321
                        sbCumInvoiceDate: '15032024'
                        portCode: INMAA1
                        eBRCNumber: EBRC0000012345
                        billNo: EXP-2024-0042
                        eBRCDt: '01042024'
                        fobFCC: 25000
                        fcc: USD
                        processingStatus: Processed
                        errorDetails: []
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    GetRequestStatusRequest:
      type: object
      properties:
        platformCustomerId:
          type: string
        requestId:
          type: string
      required:
        - platformCustomerId
        - requestId
    GetRequestStatusResponse:
      type: object
      properties:
        dgftAckId:
          type: string
        requestId:
          type: string
        recordResCount:
          type: number
        recordProCount:
          type: number
        recordFailCount:
          type: number
        processingStatus:
          type: string
          description: Overall request processing status
          enum:
            - Processed
            - Errored
        ebrcBulkGenStatusLst:
          type: array
          items:
            $ref: '#/components/schemas/EbrcBulkGenStatus'
          description: Per-record generation status (field name as returned on the wire).
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
    EbrcBulkGenStatus:
      type: object
      properties:
        serialNo:
          type: string
        irmNumber:
          type: string
        irmDt:
          type: string
        iecNumber:
          type: string
        sbCumInvoiceNumber:
          type: string
        sbCumInvoiceDate:
          type: string
        portCode:
          type: string
        eBRCNumber:
          type: string
        billNo:
          type: string
        eBRCDt:
          type: string
        fobFCC:
          type: number
        fcc:
          type: string
        processingStatus:
          type: string
          description: Per-record processing status
          enum:
            - Processed
            - Errored
        errorDetails:
          type: array
          items:
            type: object
  securitySchemes:
    x-api-key:
      type: apiKey
      name: x-api-key
      in: header

````