Karnataka Drug License - License Type

Endpoint Overview

GET /api/v1/corporate/karnataka-drug-license/license-type

Description

The Karnataka Drug License Type API provides a comprehensive list of available drug license categories recognized by the Karnataka State Pharmacy Council. This endpoint serves as a reference API that returns all valid license type classifications for drug establishments operating in Karnataka, India.

This API is essential for applications that need to validate, categorize, or display drug license types during user onboarding, compliance verification, or license management workflows. By providing standardized license type information, it ensures consistency across your application and helps maintain regulatory compliance with Karnataka state pharmaceutical regulations.

Key Benefits

Standardized Classification: Access official drug license categories as recognized by Karnataka authorities

Simplified Validation: Validate user inputs against authentic license types to prevent errors during registration or verification

Dynamic Updates: Retrieve the latest license type information without hardcoding values in your application

Regulatory Compliance: Ensure your application uses correct license terminology aligned with state pharmaceutical regulations

Use Cases

Pharmaceutical E-Commerce

Healthcare Platforms

Supply Chain & Logistics

License Verification: Validate seller credentials by checking their license type against authorized categories before onboarding new pharmaceutical vendors

Search & Filter: Enable customers to filter pharmacies based on license types (retail, wholesale) to find appropriate vendors

Compliance Dashboards: Display license type information on vendor profiles to build customer trust and ensure transparency

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. Format: `Bearer YOUR_JWT_TOKEN`
Content-Type	Yes	Must be set to `application/json`

Request Body

This is a GET endpoint and does not require a request body. All license type information is returned in the response.

Example Request

Process Response

Response Parameters

Parameter	Type	Description
data	object	Container object for the response data
data.license_type	array	Array of strings containing all available drug license types in Karnataka
status_code	integer	HTTP status code of the response (200 for success)
message_code	string	Machine-readable status code indicating the result of the operation
message	string	Human-readable message describing the result
success	boolean	Indicates whether the API call was successful (true/false)

License Types Explained

License Type	Description
retail	License for retail sale of drugs directly to consumers through physical pharmacy stores
wholesale	License for wholesale distribution of drugs to other licensed entities (hospitals, retailers)
restricted	License for handling restricted or controlled substances with special regulatory requirements
mobile	License for mobile pharmacy units that operate from vehicles and serve multiple locations

Example Successful Response

{
    "data": {
        "license_type": [
            "retail",
            "wholesale",
            "restricted",
            "mobile"
        ]
    },
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Unauthorized (401)

Forbidden (403)

Internal Server Error (500)

{
    "status_code": 401,
    "message_code": "unauthorized",
    "message": "Invalid or expired authentication token",
    "success": false
}

This error occurs when the JWT token is missing, invalid, or has expired. Verify that you're including the correct Bearer token in the Authorization header.

Integration Best Practices

Security Recommendations

Token Management: Store JWT tokens securely using environment variables or secure credential management systems. Never hardcode tokens in your application code

HTTPS Only: Always use HTTPS endpoints to ensure encrypted communication and prevent token interception

Token Rotation: Implement automatic token refresh mechanisms to handle token expiration gracefully

Rate Limiting: Implement caching for license type data to minimize API calls and respect rate limits

Error Handling: Implement comprehensive error handling to manage authentication failures and service disruptions

User Experience Guidelines

Dropdown Population: Use the API response to dynamically populate license type dropdowns during user registration or profile updates

Caching Strategy: Cache the license type list locally for at least 24 hours as these values change infrequently, improving application performance

Fallback Options: Implement fallback UI with a manual input field if the API is temporarily unavailable

Display Names: Consider mapping the returned license types to more descriptive display names for better user comprehension (e.g., "retail" → "Retail Pharmacy License")

Validation Feedback: Provide clear validation messages if users select or enter invalid license types

Code Samples

cURL

Python

Node.js

Related APIs

Karnataka Drug License Verification API - Verify the authenticity and validity of drug licenses issued by the Karnataka State Pharmacy Council using license numbers

Karnataka Drug License Details API - Retrieve comprehensive details about a specific drug license including licensee information, license validity, and authorized activities

Multi-State Drug License Verification API - Verify drug licenses across multiple Indian states for businesses operating in multiple jurisdictions

Compliance and Legal Considerations

This API provides reference data for drug license types as recognized by the Karnataka State Pharmacy Council. The license types returned are current as of the API response date but may be subject to regulatory updates. Organizations using this API should:

Regulatory Updates: Monitor notifications from the Karnataka Drugs Control Department for any changes to license classifications or requirements

Data Usage: Use this data solely for legitimate business purposes such as vendor verification, compliance management, and regulatory reporting

Privacy Compliance: Ensure that any license verification workflows comply with applicable data protection regulations and obtain necessary user consents

Legal Validity: This API provides informational data only and does not constitute legal verification of license validity or status. For official verification, consult the Karnataka Drugs Control Department

Liability: Organizations are responsible for implementing appropriate validation and verification workflows beyond the reference data provided by this endpoint

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

{ "data": { "license_type": [ "retail", "wholesale", "restricted", "mobile" ] }, "status_code": 200, "message_code": "success", "message": "Success", "success": true }

License Type

Karnataka Drug License - License Type#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

License Types Explained#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses