FSSAI License Expiry Check API
VALIDATE FSSAI LICENSE EXPIRY AND GET FBO DETAILS
Introduction
Food Safety and Standards Authority of India (FSSAI), a statutory body under The Ministry of Health and Family Welfare, Government of India, assigns a unique 14 digit license to the food product manufacturing and distribution companies, also known as FSSAI License Number, to be displayed on the food product packaging. According to the Food Safety and Standards Act of 2006, this license proves that the FBO is in compliance and has a valid license.
An FSSAI license can be valid for one to five years. This API offers a real time verification of the expiry of such license. For a given pair of FSSAI number and expiry date, this API returns if the provided details are valid and returns the issued date, name and address of the entity, type of license and other basic details.
To get the list of products covered under the FSSAI license and other details, please refer to FSSAI License Check API
API Details
Request
| Type | URL |
|---|---|
| POST | https://api.attestr.com/api/{version}/public/checkx/fssai-validity |
Request Header Parameters
| Type | Name | Value / Description | Optional | Min Version | Max Version |
|---|---|---|---|---|---|
| String | Content-Type | application/json | Required | v1 | |
| String | Authorization | Basic {authToken} | Required | v1 |
Request Body Parameters
| Type | Name | Description | Optional (default) | Min Version | Max Version |
|---|---|---|---|---|---|
| String | reg | Input FSSAI number to be verified. | Required | v1 | |
| Date | expiry | Expiry date in YYYY-MM-DD format | Required | v1 |
If you do not have the authentication token, please refer to Register App to generate one.
Sample Request Body
{ "reg": "21523038000517", "expiry": "2024-02-23"}Response
Http Status 200
Please note that the valid key decides the availability of rest of the keys in the response. If provided license number is invalid, then all keys except valid and message are either omitted or set as null. If true, remaining keys will have appropriate data
| Key | Description | Type | Min Version | Max Version |
|---|---|---|---|---|
| valid | Indicates if the provided combination of FSSAI license and expiry date exists and is valid. False if the license number does not exist. | String | v1 | |
| message | Error message if valid is false | String | v1 | |
| status | Status of FSSAI license registration e.g. License Issued etc. | String | v1 | |
| statusId | Status Id as per the FSSAI database | String | v1 | |
| issuedDate | Date of issue of the license DD-MM-YYYY | Date | v1 | |
| expiryDate | Date of expiry in DD-MM-YYYY format | Date | v1 | |
| appliedForRenewal | Flag indicating if the renewal application has already been filed by the company | Boolean | v1 | |
| entity | Name of the registered company | String | v1 | |
| reg | FSSAI license number. Same as input reg value. | String | v1 | |
| category | License category - State or Central | String | v1 | |
| address | Premise address of the registered entity | String | v1 |
Sample Response For Valid License Number And Expiry Date
{ "valid": true, "message": null, "statusId": 5, "status": "Registration Certificate issued", "issuedDate": "24-02-2023", "expiryDate": "23-02-2024", "entity": "Hotel Signature / VISHAL NANEKAR", "reg": "21523038000517", "category": 3, "address": " Yelwadi , Post - Dehugaon, Near by Bhiravnath chowk , T . Khed . D. Pune,Khed,Pune,Maharashtra,412109", "appliedForRenewal": false}Sample Response For Invalid License Number
{ "valid": false, "message": "No matching record found", "statusId": null, "status": null, "issuedDate": null, "expiryDate": null, "entity": null, "reg": null, "uuid": null, "category": null, "address": null, "appliedForRenewal": null}Error Response
Error Codes
| HTTP Status | Error Code | Error Message |
|---|---|---|
| 400 | 4001 | Malformed data or missing required parameter values |
| 400 | 4005 | Operation could not be performed due to low credits balance |
| 401 | 4016 | Invalid client authorization |
| 403 | 4031 | Unauthorized access |
| 403 | 4035 | Requested service is not provisioned for your account |
| 403 | 4039 | Client's IP address is not whitelisted |
| 403 | 4035 | Requested service is not provisioned for your account |
| 429 | 4291 | Maximum account rate limit exceeded |
| 429 | 4292 | Maximum API rate limit exceeded |
| 429 | 4293 | Maximum account daily limit exceeded |
| 429 | 4294 | Maximum API daily limit exceeded |
| 500 | 5001 | Request could not be processed |
| Parameter | Type | Description |
|---|---|---|
| code | Number | Unique error codes for different errors. Always available. |
| message | String | Error message describing the error. Always Available. |
| details | String | Detail error message. Available only for certain types of errors. |
Sample Error Response
{ "httpStatusCode": 400, "code": 4001, "message": "Malformed data or missing required parameter values", "appError": true}