{
  "openapi": "3.0.3",
  "info": {
    "title": "Infyner Company Intelligence API",
    "description": "Public REST API for Indian company, director, GST and verification data. Authenticate with a Bearer API key from https://www.infyner.com/account/api. Pricing: https://www.infyner.com/api-pricing. This specification lists verified live routes only.",
    "version": "1.0.0",
    "contact": {
      "name": "Infyner API",
      "url": "https://www.infyner.com/developers",
      "email": "api@infyner.com"
    }
  },
  "servers": [
    {
      "url": "https://api.infyner.com",
      "description": "Production API host"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "Use pk_test_… or pk_live_… from the Infyner API console. Never embed live secrets in browser code."
      }
    }
  },
  "paths": {
    "/v1/companies/search": {
      "get": {
        "summary": "Company search",
        "operationId": "companySearch",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": { "type": "string" },
            "description": "Company name or CIN"
          }
        ],
        "responses": {
          "200": { "description": "Matching companies" }
        }
      }
    },
    "/v1/companies/{cin}": {
      "get": {
        "summary": "Company CIN lookup",
        "operationId": "companyLookup",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Core company identity" }
        }
      }
    },
    "/v1/companies/{cin}/pan": {
      "get": {
        "summary": "CIN to PAN",
        "operationId": "cinToPan",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "PAN when available in Infyner master" }
        }
      }
    },
    "/v1/companies/{cin}/profile": {
      "get": {
        "summary": "Company profile",
        "operationId": "companyProfile",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Profile snapshot" }
        }
      }
    },
    "/v1/companies/{cin}/financials": {
      "get": {
        "summary": "Company financials",
        "operationId": "companyFinancials",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Year-wise financials where available" }
        }
      }
    },
    "/v1/companies/{cin}/directors": {
      "get": {
        "summary": "Company directors",
        "operationId": "companyDirectors",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Directors list" }
        }
      }
    },
    "/v1/companies/{cin}/charges": {
      "get": {
        "summary": "Company charges",
        "operationId": "companyCharges",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Registered charges" }
        }
      }
    },
    "/v1/companies/{cin}/compliance": {
      "get": {
        "summary": "Company compliance",
        "operationId": "companyCompliance",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Compliance snapshot" }
        }
      }
    },
    "/v1/companies/{cin}/documents": {
      "get": {
        "summary": "Company documents",
        "operationId": "companyDocuments",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Filed document list" }
        }
      }
    },
    "/v1/directors/{din}": {
      "get": {
        "summary": "Director lookup",
        "operationId": "directorLookup",
        "parameters": [
          {
            "name": "din",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Director profile" }
        }
      }
    },
    "/v1/directors/{din}/companies": {
      "get": {
        "summary": "Director companies",
        "operationId": "directorCompanies",
        "parameters": [
          {
            "name": "din",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "Companies linked to DIN" }
        }
      }
    },
    "/v1/verify/cin/{cin}": {
      "get": {
        "summary": "Verify CIN",
        "operationId": "verifyCin",
        "parameters": [
          {
            "name": "cin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "CIN verification result" }
        }
      }
    },
    "/v1/verify/din/{din}": {
      "get": {
        "summary": "Verify DIN",
        "operationId": "verifyDin",
        "parameters": [
          {
            "name": "din",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "DIN verification result" }
        }
      }
    },
    "/v1/verify/gstin/{gstin}": {
      "get": {
        "summary": "Verify GSTIN",
        "operationId": "verifyGstin",
        "parameters": [
          {
            "name": "gstin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "GSTIN verification result" }
        }
      }
    },
    "/v1/verify/pan/{pan}": {
      "get": {
        "summary": "Verify PAN",
        "operationId": "verifyPan",
        "parameters": [
          {
            "name": "pan",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "PAN verification result" }
        }
      }
    },
    "/v1/gst/{gstin}": {
      "get": {
        "summary": "GSTIN lookup",
        "operationId": "gstinLookup",
        "parameters": [
          {
            "name": "gstin",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "GST details" }
        }
      }
    },
    "/v1/search/pan/{pan}": {
      "get": {
        "summary": "PAN to GSTIN search",
        "operationId": "panLookup",
        "parameters": [
          {
            "name": "pan",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": { "description": "GSTINs under PAN" }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Human documentation and marketplace",
    "url": "https://www.infyner.com/developers"
  }
}