FSSAI Certificate

Endpoint Overview

POST /api/v1/corporate/fssai-certificate

Description

This API allows users to download the Food Safety and Standards Authority of India (FSSAI) Certificate by providing a valid FSSAI license number. The service verifies the license number against official FSSAI records and returns a downloadable certificate link if the license is valid. This enables businesses to quickly retrieve official FSSAI documentation for compliance, verification, and record-keeping purposes.

Key Benefits

Instant access to official FSSAI certificates without manual website navigation

Simplified compliance verification for food businesses and their partners

Seamless integration into existing business workflows and applications

Reliable document retrieval with digital certificate links for record-keeping

Use Cases

Food Industry

Retail & E-commerce

Compliance & Auditing

Restaurants and food service businesses can verify and download their FSSAI certificates for display

Food manufacturers can retrieve certificates for product packaging compliance

Food delivery platforms can verify restaurant compliance during onboarding

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	Valid FSSAI license number to retrieve the certificate

Example Request

{
    "id_number": "228190151234123"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the certificate information
data.client_id	String	Unique identifier for the request
data.id_number	String	FSSAI license number that was provided in the request
data.certificate_link	String	URL to download the FSSAI certificate (PDF format)
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the request was successful
message	String or null	Additional information about the response (null if successful)
message_code	String	Code indicating the status of the response

Example Successful Response

{
    "data": {
        "client_id": "corporate_fssai_certificate_DpRymJYjoZdbdpcjxneU",
        "id_number": "228190151234123",
        "certificate_link": "https://aadhaar-kyc-docs.s3.amazonaws.com/fssai_certificate/105813727/corporate_fssai_certificate_VgzufwLchueLuwryfNFY-2024-08-22-143109918728.pdf"
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "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 in an incorrect format or contains invalid characters.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption

Rotate JWT tokens periodically and implement token expiration policies

User Experience Guidelines

Implement caching mechanisms to improve response times for frequently accessed certificates

Provide clear error messages to end-users when license verification fails

Include a download button for the certificate_link to improve usability

Display certificate expiration information when presenting the certificate to users

Code Samples

cURL

Python

Node.js

Related APIs

Business Verification API: Verify business registration details and documents

GST Verification API: Validate GST registration numbers and retrieve business information

Shop & Establishment API: Retrieve shop and establishment certificates for business premises

Corporate PAN Verification API: Verify Permanent Account Number details for businesses

Compliance and Legal Considerations

The FSSAI certificate data retrieved through this API is subject to Food Safety and Standards Authority of India regulations. The certificate should only be used for legitimate business purposes and compliance verification. Unauthorized distribution or misrepresentation of FSSAI certificates may violate food safety regulations and can result in legal penalties. Ensure that you have proper authorization to access and store FSSAI certificate information.

{ "data": { "client_id": "corporate_fssai_certificate_DpRymJYjoZdbdpcjxneU", "id_number": "228190151234123", "certificate_link": "https://aadhaar-kyc-docs.s3.amazonaws.com/fssai_certificate/105813727/corporate_fssai_certificate_VgzufwLchueLuwryfNFY-2024-08-22-143109918728.pdf" }, "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 Certificate

FSSAI Certificate#

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

FSSAI Certificate

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples