{"openapi":"3.1.0","info":{"title":"IndiaCos API","version":"1.0.0","description":"Free, keyless API for Indian GST registrations, PAN lookups, business search and court-case summaries. CC BY 4.0: credit IndiaCos (indiacos.com).","contact":{"email":"support@indiacos.com"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://indiacos.com/api/v1"}],"paths":{"/gst/{gstin}":{"get":{"summary":"GST registration by GSTIN","operationId":"getGst","parameters":[{"name":"gstin","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{2}[A-Z0-9]{13}$"},"example":"27AAOCM9194L2ZF"}],"responses":{"200":{"description":"Registration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Gst"}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/gst/{gstin}/cases":{"get":{"summary":"Court cases naming this business (companies, LLPs, firms only)","operationId":"getCases","parameters":[{"name":"gstin","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{2}[A-Z0-9]{13}$"},"example":"27AAOCM9194L2ZF"}],"responses":{"200":{"description":"Case summary"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/company/{cin}":{"get":{"summary":"Company or LLP by CIN / LLPIN","operationId":"getCompany","parameters":[{"name":"cin","in":"path","required":true,"schema":{"type":"string"},"example":"U72900KL2022PTC074151"}],"responses":{"200":{"description":"Company"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/company/{cin}/cases":{"get":{"summary":"Court cases naming this company or LLP","operationId":"getCompanyCases","parameters":[{"name":"cin","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Case summary"},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/pan/{pan}":{"get":{"summary":"All GST registrations under a PAN","operationId":"getPan","parameters":[{"name":"pan","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Z]{5}[0-9]{4}[A-Z]$"},"example":"AAOCM9194L"}],"responses":{"200":{"description":"List"},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/search":{"get":{"summary":"Search businesses by name, or by GSTIN","operationId":"search","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"state","in":"query","schema":{"type":"string","pattern":"^[0-9]{2}$"},"description":"GST state code"}],"responses":{"200":{"description":"List"},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/stats":{"get":{"summary":"Coverage counts","operationId":"stats","responses":{"200":{"description":"Counts"}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}}},"Gst":{"type":"object","properties":{"gstin":{"type":"string"},"legal_name":{"type":"string"},"trade_name":{"type":["string","null"]},"pan":{"type":"string"},"pan_holder_type":{"type":"string"},"constitution":{"type":"string"},"taxpayer_type":{"type":"string"},"status":{"type":"string"},"registration_date":{"type":"string","format":"date"},"nature_of_business":{"type":"array","items":{"type":"string"}},"address":{"type":"object"},"jurisdiction":{"type":"object"},"turnover_band":{"type":["object","null"]},"contact":{"type":"object","description":"Masked"},"retrieved_on":{"type":"string"},"url":{"type":"string"}}}}}}