FSSAI V3 API

Endpoint Overview

POST /api/v1/corporate/fssai-v3

Description

The FSSAI V3 API provides comprehensive validation and detailed information retrieval for Food Safety and Standards Authority of India (FSSAI) licenses. This endpoint enables businesses to verify the authenticity of FSSAI licenses, retrieve complete business registration details, and access critical compliance information including license status, product categories, and business classifications.

This API delivers real-time verification results with extensive business intelligence data, making it essential for supply chain management, vendor onboarding, regulatory compliance, and risk assessment in the food and beverage industry.

Key Benefits

Real-time FSSAI license verification with comprehensive business details and compliance status

Complete product category mapping to understand authorized manufacturing and trading permissions

Enhanced due diligence capabilities with business classification, ownership details, and operational scope

Regulatory compliance support with license validity periods, status tracking, and renewal information

Use Cases

Food & Beverage Industry

E-commerce Platforms

Financial Services

Vendor verification and supplier onboarding for food manufacturers and distributors

Supply chain compliance monitoring to ensure all partners maintain valid FSSAI licenses

Product category validation before establishing business partnerships or procurement agreements

Quality assurance programs requiring verified food safety certifications from suppliers

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

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

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication (JWT format)
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	FSSAI license number (14-digit identifier)
get_products	boolean	No	Flag to include product categories in response (default: false)
get_license_active_flag	boolean	No	Flag to include license active in response (default: false)

Example Request

{
  "id_number": "45678912345678",
  "get_products": true,
  "get_license_active_flag": true
}

Process Response

Response Parameters

Parameter	Type	Description
data.client_id	string	Unique client identifier for the API request
data.id_number	string	FSSAI license number that was verified
data.reference_id	integer	Internal reference ID for the business entity
data.kind_of_business	string	Business category classification (e.g., Manufacturing - Beverages)
data.details.company_name	string	Registered business name
data.details.taluk_name	string	Taluk/Sub-district name where business is located
data.details.taluk_premises	integer	Number of premises in the taluk
data.details.number_of_years	integer	Years of business operation
data.details.district_name	string	District name of business location
data.details.district_premises	integer	Number of premises in the district
data.details.state_name	string	State name of business location
data.details.state_premises	string	State code abbreviation
data.details.designation_name	string	Owner/operator designation (e.g., Proprietor)
data.details.full_name	string	Full name of the license holder
data.details.certificate_number	string	FSSAI certificate number
data.details.license_category_name	string	License category (Central/State/Local)
data.details.issued_date	string	License issue date (YYYY-MM-DD format)
data.details.expiry_date	string	License expiry date (YYYY-MM-DD format)
data.details.fbo_id	integer	Food Business Operator ID
data.details.app_submission_date	string	Application submission date
data.details.last_updated_on	string	Last update timestamp
data.details.address	string	Complete business address
data.details.status_desc	string	License status description
data.details.app_type_desc	string	Application type description
data.details.app_type	string	Application type code
data.details.pincode	integer	Postal code of business location
data.details.products	array	List of authorized product categories
data.details.license_active_flag	boolean	License active status indicator
status_code	integer	HTTP status code
success	boolean	Request success indicator
message	string	Response message
message_code	string	Response message code

Example Successful Response

{
  "data": {
    "client_id": "corporate_fssai_v3_ovuibNCaHzKfcaxlUrKr",
    "id_number": "45678912345678",
    "reference_id": 987654321,
    "kind_of_business": "Manufacturing - Beverages",
    "details": {
      "company_name": "Sharma Beverages Pvt Ltd",
      "taluk_name": "Vijayanagar",
      "taluk_premises": 2211,
      "number_of_years": 5,
      "district_name": "Bengaluru Urban",
      "district_premises": 120,
      "state_name": "Karnataka",
      "state_premises": "KA",
      "designation_name": "Proprietor",
      "full_name": "Rohit Sharma",
      "certificate_number": "45678912345678",
      "license_category_name": "Central License",
      "issued_date": "2022-06-15",
      "expiry_date": "2027-06-14",
      "fbo_id": 87654321,
      "app_submission_date": "2022-05-10",
      "last_updated_on": "2022-06-15",
      "address": "45, MG Road, Vijayanagar, Bengaluru Urban, Karnataka, 560040",
      "status_desc": "License Active",
      "app_type_desc": "New License",
      "app_type": "N",
      "pincode": 560040,
      "products": [
        "14 - Non-alcoholic beverages",
        "07 - Bakery products"
      ],
      "license_active_flag": true
    }
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Possible Error Responses

Invalid License Number

Authentication Error

{
    "status_code": 422,
    "success": false,
    "message": "Verification Failed.",
    "message_code": "verification_failed"
}

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

Integration Best Practices

Security Recommendations

Store JWT tokens securely and implement automatic token refresh mechanisms

Use HTTPS for all API communications to ensure data encryption in transit

Implement rate limiting and request throttling to prevent API abuse

Log API requests for audit trails while ensuring sensitive data is not exposed

User Experience Guidelines

Display license expiry dates prominently to users for compliance awareness

Implement caching for frequently queried license numbers to improve response times

Provide clear error messages and guidance when license verification fails

Show product categories clearly when available to help users understand business scope

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify business PAN details for comprehensive business validation

GST Verification API: Cross-verify GST registration with FSSAI license for complete compliance

Corporate Master Data API: Access detailed company information and corporate structure

Address Verification API: Validate business addresses and operational locations

Compliance and Legal Considerations

FSSAI license verification is mandatory for food business operations in India. Ensure that all verified information is used in compliance with food safety regulations and data privacy laws. This API should be used for legitimate business verification purposes only, and the retrieved data must be handled according to applicable privacy regulations and FSSAI guidelines.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/fssai-v3' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "45678912345678", "get_products": true, "get_license_active_flag": true }'

{ "data": { "client_id": "corporate_fssai_v3_ovuibNCaHzKfcaxlUrKr", "id_number": "45678912345678", "reference_id": 987654321, "kind_of_business": "Manufacturing - Beverages", "details": { "company_name": "Sharma Beverages Pvt Ltd", "taluk_name": "Vijayanagar", "taluk_premises": 2211, "number_of_years": 5, "district_name": "Bengaluru Urban", "district_premises": 120, "state_name": "Karnataka", "state_premises": "KA", "designation_name": "Proprietor", "full_name": "Rohit Sharma", "certificate_number": "45678912345678", "license_category_name": "Central License", "issued_date": "2022-06-15", "expiry_date": "2027-06-14", "fbo_id": 87654321, "app_submission_date": "2022-05-10", "last_updated_on": "2022-06-15", "address": "45, MG Road, Vijayanagar, Bengaluru Urban, Karnataka, 560040", "status_desc": "License Active", "app_type_desc": "New License", "app_type": "N", "pincode": 560040, "products": [ "14 - Non-alcoholic beverages", "07 - Bakery products" ], "license_active_flag": true } }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

FSSAI V3

FSSAI V3 API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses