To view the details of BoE (Bill of Entry) on the GST Portal, perform following steps:
1. Access the www.gst.gov.in URL. The GST Home page is displayed. Click the Services > User Services > Search BoE option.
2. SEARCH BILL OF ENTRY FROM ICEGATE page is displayed.
3. Click on the SEARCH BILL OF ENTRY button to add upto 10 rows of records in bulk.
3.1 SEARCH BILL OF ENTRY page is displayed. Enter the Port Code, Bill of Entry Number, Bill of Entry Date and Reference Date.
Note 1: The Port Code must contain exactly 6 alphanumeric characters. If the taxpayer enters a Port Code that exceeds or is less than 6 alphanumeric characters, the following error will be displayed in red within the tab:
Note 2: If the taxpayer does not fill any of the fields—Port Code, Bill of Entry Number, Bill of Entry Date, or Reference Date—an error will be displayed in red within the tab.
Note 3: If the taxpayer enters a duplicate Bill of Entry Number, an error will be displayed in red within the respective tab, even if the other fields—Bill of Entry Date, Reference Date, or Port Code—are the same.
Note 4: If the taxpayer enters a Bill of Entry Number with less than 4 digits or more than 7 digits, an error will be displayed.
Note 5: Reference date is the date when the goods have been cleared from Customs (Passed out of Customs charge). The reference date will either be Out of charge date, Duty payment date, or amendment date - whichever is later. If the Reference Date is not at least five days prior to today's date (including the Reference Date as one of the five days), an error will be displayed.
If the Reference date is entered is less than the Bill of Entry Date, the following error will be displayed:
If the Reference Date is not at least five days prior to today's date (including the Reference Date), and is earlier than the Bill of Entry Date, two separate error messages will be displayed at the same time in red within the tab.
3.2 Taxpayer can add upto maximum of 10 records by clicking on the + icon under Actions tab.
Note: Once the + symbol under the Actions tab is selected for a new row, it will automatically be disabled for all previously added rows. And, after adding 10 records, the + button will be frozen.
3.3 To delete any record, taxpayer can click on the delete button under Actions tab.
3.4 Once all mandatory BOE details are filled and the taxpayer clicks the BACK button, the following warning message will appear.
The taxpayer will then see two options:
Cancel: Keeps the entered record details and redirects back to the SEARCH BILL OF ENTRY page.
Proceed: Clears all entered data and redirects to the SEARCH BILL OF ENTRY FROM ICEGATE page.
3.5 The taxpayer can click on the QUERY ICEGATE button after filling all four mandatory BOE fields to fetch up to 10 records from the ICEGATE portal into the GST system.
When the request is successfully submitted, following success message is displayed.
If the taxpayer tries to submit a second request while the first is still processing, the following error message is displayed:
4. Click on the BULK SEARCH button to add records of more than 10 rows but upto maximum 50 rows.
4.1. SEARCH BOE - Bulk Upload page is displayed.
4.2 Download the BULK Upload Excel Template by clicking on the Click here to download Bulk Upload Excel Template hyperink.
4.2a A zip file is downloaded in your system.
4.2b Extract the zip file and open the Excel template to validating records.
4.2c Fill in the required details GSTIN, Sr No, Port Code, Bill of Entry Number, Bill of Entry Date, and Reference Date in the SEARCH BOE RECORDS section. Click on the Validate Sheet button.
4.2d If all the records are valid, then the following success message will be displayed on the screen and Validation Status will be changed to Validation Successful.
The following error messages can be displayed while validating the sheet.
1. If the taxpayer enters fewer than 11 records, the following error message will be displayed on the screen.
2. If the taxpayer leaves the GSTIN field blank, the following error message will be displayed.
When the taxpayer hovers over the highlighted GSTIN field, the following hover message will appear:
3. If anything other than numbers (-ve value, 0 or special characters (231@12 or only @)) are entered in the Bill of Entry Number field, the following error message will be displayed.
Note: If any of the records is not valid or there is any error in the records, then on clicking the Validate Sheet button, following error message will be displayed on the screen.
When the taxpayer hovers over the highlighted field, the following hover message will appear in different scenarios:
1. If taxpayer enters invalid GSTIN value, the following error message will be displayed.
2. If the taxpayer leaves the Serial Number field blank, the following error message will be displayed.
3. If the taxpayer enters an incorrect value in the Serial Number field, the following error message will be displayed.
4. If the Port Code field contains fewer or more than 6 alphanumeric characters, the following error message will be displayed.
5. If the Bill of Entry Number contains fewer than 4 digits or more than 7 digits, the following error message will be displayed.
6. If the Reference Date is not entered at least five days prior to the current date, the following error message will be displayed.
Example: The Current Date is 28-10-2025, Reference Date is 27-10-2025 and the Bill of Entry Date is 20-10-2025.
7. If the Reference Date entered is earlier than the Bill of Entry Date, the following error message will be displayed.
8. If any of the mandatory field are not filled, the following error message will be displayed.
9. When the taxpayer makes a duplicate entry, an error message will be shown on hovering the particular tab.
4.2e After successful validations, click on the Generate JSON File button to convert the excel file into JSON file.
4.2f Click on the SAVE button to save the JSON file into your system.
After successfully saving the file, a success message will be displayed on the screen.
Note: If taxpayer tries to generate JSON file without validating the records, then the following error message will be isplayed on the screen.
4.3 Choose the correct JSON file from the saved records in your system for upload.
4.4 Click on the Upload button to upload the selected JSON file.
Note: If you click on the UPLOAD button without choosing any JSON file, then the following message will be displayed on the screen.
Click on the BACK button to return to the SEARCH BILL OF ENTRY FROM ICEGATE page.
4.5 If the correct JSON file is uploaded successfully, the data will be automatically transferred and displayed. Also, a success message will appear in green:
If the wrong JSON file is uploaded, an error message will be displayed:
4.6 You can select the number of records displayed per page by clicking the dropdown under Records Per Page.
4.7 The BULK SEARCH page must always have a minimum of 11 and a maximum of 50 records. You can click on the DELETE option to remove records exceeding 10 but up to maximum 50. Also, the following error message will be displayed on the screen If fewer than 11 records are maintained.
4.8 Click on the QUERY ICEGATE button after all record details are automatically fetched from the Search BOE-Bulk Upload page upon uploading the correct JSON file.
4.9 When the request is successfully submitted, following success message is displayed.
If the taxpayer tries to submit a second requestwhile the first is still processing, the following error message is displayed:
4.10 Once all the records are automatically fetched and the taxpayer clicks the BACK button, the following warning message will appear.
The taxpayer will then see two options:
Cancel: Keeps the entered record details and redirects back to the BULK SEARCH page.
Proceed: Clears all entered data and redirects to the SEARCH BOE - BULK UPLOAD page.
5. Click on the SEARCH HISTORY button to view he previous search history records in GST system and those fetched from ICEGATE portal.
5.1 History of Query ICEGATE page is displayed. You can see the history of fetched BOE details from ICEGATE along with status of query.
Note: By default, only records from the last three months are displayed .
5.2 Taxpayer can search the data by entering keywords in the global search option by clicking on the Search button.
Note: If the taxpayer performs a Global Search and no records are found, the following error message will be displayed on the screen.
Note: If the taxpayer clicks the Search History button and no records are found, the following error message will be displayed on the screen.
5.3 Taxpayer can apply From Date and To Date filters to search Bill of Entry Date and Reference Date.
Note: If the taxpayer applies filters on the Bill of Entry Date and no records are found within the last 3 months, the following error message will be displayed on the screen.
5.4 Taxpayer can also apply Status filter by clicking on the dropdown.
Note: The following message is displayed on hovering the information icon on Status.
5.5 Click on the DOWNLOAD (EXCEL) button to download all the records from last 3 months. An excel file will be downloaded in your system.
An excel file will be downloaded in your system. Check all the details in the downloaded file.
