FSSAI Verification API

Endpoint Overview

POST /api/v1/corporate/fssai

Description

The FSSAI Verification API allows you to validate and retrieve comprehensive details about a Food Safety and Standards Authority of India (FSSAI) license by providing the license number. This API returns authenticated information about the license holder, including company details, license status, and registration information directly from official FSSAI records.

Key Benefits

Instant verification of FSSAI license authenticity

Access to comprehensive business details including company name, address, and license status

Streamlined compliance verification for food industry partners

Reduced manual verification overhead and improved due diligence processes

Use Cases

Food Industry

E-commerce

Financial Services

Verify suppliers' FSSAI credentials before establishing business relationships

Automate vendor onboarding with instant license verification

Maintain compliance records for food safety audits

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	JWT Bearer token for authentication. Format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

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

Example Request

{
    "id_number": "123400150004321"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification results
data.client_id	String	Unique identifier for this verification request
data.fssai_number	String	The FSSAI number that was verified
data.details	Array	Array containing license details
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Details Object Properties

Parameter	Type	Description
address	String	Registered address of the FSSAI license holder
license_no	String	FSSAI license number
fbo_id	Integer	Food Business Operator ID as per FSSAI records
display_ref_id	String	Company display reference number
license_category_name	String	FSSAI license registration category name
state_name	String	State where the license is registered
status_desc	String	License status description (e.g., "License Issued")
license_category_id	Integer	Numeric identifier for license category
company_name	String	Registered name of the company
license_active_flag	Boolean	Indicates if the license is currently active
ref_id	Integer	FSSAI reference ID
app_type_desc	String	FSSAI application registration type
premise_pincode	Integer	Postal code of the registered premises

Example Successful Response

{
    "data": {
        "client_id": "corporate_fssai_xodcLhZpvunkpIBiytEC",
        "fssai_number": "123400150004321",
        "details": [
            {
                "address": "MANGUSHREE COMPLEX",
                "license_no": "123400150004321",
                "fbo_id": 1234567,
                "display_ref_id": "1234520005254321",
                "license_category_name": "Registration",
                "state_name": "Bengal",
                "status_desc": "License Issued",
                "license_category_id": 3,
                "company_name": "SUR ENTERPRISE",
                "license_active_flag": false,
                "ref_id": 987654321,
                "app_type_desc": "New Registration",
                "premise_pincode": 123456
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid License Number

License Not Found

Authentication Error

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

The provided FSSAI license number is not in the correct format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API keys securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Rotate JWT tokens periodically and implement token expiration

User Experience Guidelines

Implement appropriate loading indicators during API calls

Display clear error messages to users when verification fails

Cache verification results when appropriate to improve performance

Provide clear instructions on how to correct invalid license numbers

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify Permanent Account Number details for businesses and individuals

GST Verification API: Validate Goods and Services Tax registration information

Business Registration API: Verify company registration details

Address Verification API: Validate physical business addresses

Compliance and Legal Considerations

The FSSAI data provided through this API is sourced from official government records. When implementing this API, ensure you comply with data protection regulations and use the information only for legitimate business purposes. The verification should be used as part of your due diligence process but may need to be supplemented with additional verification steps depending on your regulatory requirements.

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' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "123400150004321" }'

{ "data": { "client_id": "corporate_fssai_xodcLhZpvunkpIBiytEC", "fssai_number": "123400150004321", "details": [ { "address": "MANGUSHREE COMPLEX", "license_no": "123400150004321", "fbo_id": 1234567, "display_ref_id": "1234520005254321", "license_category_name": "Registration", "state_name": "Bengal", "status_desc": "License Issued", "license_category_id": 3, "company_name": "SUR ENTERPRISE", "license_active_flag": false, "ref_id": 987654321, "app_type_desc": "New Registration", "premise_pincode": 123456 } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

FSSAI

FSSAI Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Details Object Properties#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses