FSSAI V2

Endpoint Overview

POST /api/v1/corporate/fssai-v2

Description

This API allows you to verify and retrieve detailed information about a Food Safety and Standards Authority of India (FSSAI) license or registration. By providing a valid FSSAI license number, you can access comprehensive details about the food business operator, including company information, address, license status, and application details.

Key Benefits

Instant verification of FSSAI license authenticity

Access to comprehensive business details including address, license category, and status

Streamlined compliance verification for food industry partnerships

Reduced manual verification effort with automated digital checks

Use Cases

Food Industry

E-commerce

Financial Services

Verify suppliers' FSSAI credentials before establishing business relationships

Validate license status of potential food business partners

Confirm regulatory compliance of vendors in your supply chain

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	FSSAI license number to be verified

Example Request

{
    "id_number": "22819015001312"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification results
data.client_id	String	Unique client identifier for the request
data.id_number	String	FSSAI license number that was verified
data.application_number	String	FSSAI application number
data.fssai_number	String	FSSAI license number
data.details	Array	Array containing detailed information about the FSSAI license
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

Details Object Parameters

Parameter	Type	Description
address_premises	String	Company address
status_desc	String	FSSAI license status description
district_name	String	Company district name
fbo_id	Integer	Food Business Operators ID
display_ref_id	String	Display reference ID number
taluk_name	String	Taluka name
company_name	String	Company name
state_premises	String	State premises code
district_premises	Integer	District premises code
app_type_desc	String	Application type description
taluk_premises	Integer	Taluka premises code
state_name	String	State name
license_category_name	String	License category name
app_type	String	Application type code
app_submission_date	String	Application submission date (YYYY-MM-DD)
last_updated_on	String	Last update date (YYYY-MM-DD)
pincode	Integer	Postal code
ref_id	Integer	Reference ID number

Example Successful Response

{
    "data": {
        "client_id": "corporate_fssai_v2_tzsqcAruluLulxsjlrqs",
        "id_number": "00009015001234",
        "application_number": "00001207002500000",
        "fssai_number": "00009015001234",
        "details": [
            {
                "address_premises": "West Bengal, 721602",
                "status_desc": "Registration Certificate issued",
                "district_name": "Medinipur",
                "fbo_id": 000111,
                "display_ref_id": "00001207002500000",
                "taluk_name": "MUNICIPALITY",
                "company_name": "S ENTERPRISE",
                "state_premises": "WB",
                "district_premises": 000,
                "app_type_desc": "New License/New Registration",
                "taluk_premises": 12345,
                "state_name": "Bengal",
                "license_category_name": "Registration",
                "app_type": "N",
                "app_submission_date": "2000-00-07",
                "last_updated_on": "2000-00-07",
                "pincode": 12345,
                "ref_id": 98765432
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid License Number

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid FSSAI license number format",
    "message_code": "invalid_input"
}

The provided FSSAI license number is in an invalid format or doesn't exist.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling to avoid exposing sensitive information

User Experience Guidelines

Implement caching for frequently accessed FSSAI data to improve response times

Display verification status clearly to end-users with appropriate visual indicators

Provide clear error messages when verification fails

Consider implementing a retry mechanism for temporary service disruptions

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify Permanent Account Number details

GST Verification API: Verify Goods and Services Tax registration details

Business Verification API: Comprehensive business verification solution

Shop & Establishment API: Verify shop and establishment registration details

Compliance and Legal Considerations

The FSSAI data accessed through this API is subject to FSSAI regulations. This API should be used for legitimate business purposes such as vendor verification, regulatory compliance, or due diligence. Ensure you have appropriate consent when processing this data and comply with applicable data protection regulations.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/fssai-v2' \ --header 'Authorization: Bearer TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "22819015001312" }'

{ "data": { "client_id": "corporate_fssai_v2_tzsqcAruluLulxsjlrqs", "id_number": "00009015001234", "application_number": "00001207002500000", "fssai_number": "00009015001234", "details": [ { "address_premises": "West Bengal, 721602", "status_desc": "Registration Certificate issued", "district_name": "Medinipur", "fbo_id": 000111, "display_ref_id": "00001207002500000", "taluk_name": "MUNICIPALITY", "company_name": "S ENTERPRISE", "state_premises": "WB", "district_premises": 000, "app_type_desc": "New License/New Registration", "taluk_premises": 12345, "state_name": "Bengal", "license_category_name": "Registration", "app_type": "N", "app_submission_date": "2000-00-07", "last_updated_on": "2000-00-07", "pincode": 12345, "ref_id": 98765432 } ] }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

FSSAI V2

FSSAI V2#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Details Object Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

FSSAI V2

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Details Object Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples