Drug License Verification API

Endpoint Overview

POST /api/v1/corporate/drug-license

Description

The Drug License Verification API allows you to validate and retrieve detailed information about pharmaceutical licenses across multiple states in India. This API verifies the authenticity of drug licenses and returns comprehensive details about the license holder, including firm name, registered pharmacists, and license validity dates.

Key Benefits

Instant verification of drug license authenticity across multiple Indian states

Access to detailed license information including registered pharmacists and validity dates

Streamlined compliance verification for pharmaceutical partnerships

Reduction in manual verification processes and associated costs

Use Cases

Pharmaceutical Industry

Healthcare Providers

Regulatory Compliance

Verify potential distributor or retailer license credentials before partnership

Conduct periodic compliance checks on existing business partners

Automate vendor onboarding processes with license verification

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
state_code	Enum	Yes	State code where the drug license was issued
license_no	String	Yes	Drug license number to be verified

Supported State Codes

State	Code
Gujarat	GJ
Maharashtra	MH
Punjab	PB
Rajasthan	RJ
Uttarakhand	UA
West Bengal	WB

Example Request

{
    "state_code": "RJ",
    "license_no": "12345"
}

Process Response

Response Parameters

Parameter	Type	Description
client_id	String	Unique identifier for the verification request
state	String	State code where the license was issued
license_no	String	License number that was verified
data	Array	Array containing license details
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Additional information about the response (null if successful)
message_code	String	Code indicating the status of the response

Data Object Parameters

Parameter	Type	Description
firm_name	String	Name of the firm holding the license
city	String	Address of the firm
licences	String	Type of license(s) held
reg_pharmacists	String	Details of registered pharmacists including name, qualification, and registration information
license_valids	Array	Array of license numbers and their expiry dates

Example Successful Response

{
    "data": {
        "client_id": "corporate_drug_license_sZsdtzhsfdzYXhllTauu",
        "state": "MH",
        "license_no": "41156",
        "data": [
            {
                "firm_name": "HARI OM MEDICAL",
                "city": "GROUND FLOOR,PLOT NO. C-4, AATMAY ELIXIR,,SECTOR 8,",
                "licences": "R - 2",
                "reg_pharmacists": "ashok, DPH, [162982-11/02/2021]",
                "license_valids": [
                    [
                        "20-41195",
                        "21/02/2026"
                    ],
                    [
                        "21-41195",
                        "21/02/2026"
                    ]
                ]
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid License

Invalid State Code

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "No license found with the provided details",
    "message_code": "license_not_found"
}

The license number provided does not exist in the state's database.

Integration Best Practices

Security Recommendations

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

Implement proper error handling to prevent sensitive information leakage

Rotate JWT tokens periodically and implement token expiration policies

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

User Experience Guidelines

Implement caching for frequently verified licenses to improve response times

Display verification results clearly with visual indicators of license validity

Include license expiry warnings when expiration dates are approaching

Provide detailed error messages to end-users that are actionable and clear

Code Samples

cURL

Python

Node.js

Related APIs

GST Verification API: Verify GST registration details of businesses

PAN Verification API: Validate Permanent Account Number details

Business Registration API: Verify company registration details

Pharmacy Council Registration API: Verify pharmacist registration details

Compliance and Legal Considerations

This API provides access to regulatory data that may be subject to privacy and data protection laws. Ensure you have appropriate consent and legal basis for verifying drug licenses. The data should be used only for legitimate business purposes such as compliance verification, vendor onboarding, or regulatory requirements. Data retrieved should not be stored longer than necessary and should be protected with appropriate security measures.

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/drug-license' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "state_code": "RJ", "license_no": "12345" }'

{ "data": { "client_id": "corporate_drug_license_sZsdtzhsfdzYXhllTauu", "state": "MH", "license_no": "41156", "data": [ { "firm_name": "HARI OM MEDICAL", "city": "GROUND FLOOR,PLOT NO. C-4, AATMAY ELIXIR,,SECTOR 8,", "licences": "R - 2", "reg_pharmacists": "ashok, DPH, [162982-11/02/2021]", "license_valids": [ [ "20-41195", "21/02/2026" ], [ "21-41195", "21/02/2026" ] ] } ] }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Drug License

Drug License Verification API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Supported State Codes#

Example Request#

Response Parameters#

Data Object Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses