0% found this document useful (0 votes)
44 views43 pages

APIs List 08 April 24

The document lists 27 KYC APIs with their request and response details. The APIs provide information like PAN details, name verification, Aadhaar details verification, company profiles, GSTIN details, and bank account details. The responses include verification status, matching details, individual/company profiles, and connected bank/address details depending on the specific API requested.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
44 views43 pages

APIs List 08 April 24

The document lists 27 KYC APIs with their request and response details. The APIs provide information like PAN details, name verification, Aadhaar details verification, company profiles, GSTIN details, and bank account details. The responses include verification status, matching details, individual/company profiles, and connected bank/address details depending on the specific API requested.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 43

APIs List – KYC

APIs and EGST User


Journey 1 APIs
KYC APIs
KYC APIs List
S.no API Name
1 Fetch PAN details
2 Fetch PAN Holder Name
3 PAN verification
4 Aadhaar Number Verification
5 Fetch PAN linked details
6 Fetch Import- Export Details
7 Establishment registration details - Municipal Authorities
8 Firm Registration details
9 Fetch all GSTINs details by PAN
10 GSTIN return details
11 GSTIN profile
12 Company profile
13 Fetch TAN Details
14 MSME Details
15 Search Company By Name
16 206AB Compliance Status
17 Entity Linked details
18 Fetch GST profile details
19 Bank account details
20 Primary Business API
21 Fetch All GSTINs Details By PAN v2
22 Bank Account Details v2
23 MSME Details v2
24 Company Profile v2
25 PAN Verification V2.0
26 Aadhar Number verification v2
27 Fetch PAN to CIN
*V2 APIs is extended version of earlier APIs
KYC APIs – Request and Response – Direct API integration
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Status-Active/Inactive
1. PAN to be authenticated
1 Fetch PAN details 2. Name
2. Consent-Y/N
3. Date Of Birth

1. PAN
2 Fetch PAN Holder Name 1. Complete name of the PAN holder
2. Consent-Y/N

1. PAN Number to be authenticated


1. Status of the PAN. [Active or Inactive]
2. Exact name as per PAN
3 PAN verification 2. Whether the given name matches with the ITD Records
3. Date of birth as per PAN
3. Whether the given date of birth matches with the ITD Records
4. Consent-Y/N
1. Masked Mobile number (last 3 digits shown) linked with the Aadhaar
1. Name of the user sharing consent 2. Gender as on Aadhaar
4 Aadhaar Number Verification 2. 12- digit Aadhaar Card Number as per the Card 3. State registered as on Aadhaar
3. Consent-Y/N 4. Age band of the user as on Aadhaar
5. Return as "Y" if the Aadhaar number is issued and "N" if it is not issued
1. PAN of the Individual/Entity
2. Full Name of the Individual/Entity as per Income Tax Records
3. First Name of the Individual
4. Middle Name of the Individual
5. Last Name of the Individual
6. Gender of the Individual (Not Applicable for Entity PAN)
7. Whether an Aadhaar is linked to the PAN (Not Applicable for Entity PAN)
8. Whether given 4 digits of Aadhaar match with last four digits as per Income Tax Records (Not Applicable for Entity PAN)
9. Date of Birth/Incorporation as per Income Tax Records
10. House Number/Building details
1. PAN of the Individual / Entity
5 Fetch PAN linked details 11. Address Locality
2. Consent-Y/N
12. Street Location as on the Address
13. Pincode as on the Address
14. City as on the Address
15. State as on the Address
16. Country as on the Address
17. Mobile Number registered with Income Tax for Individual/Entity
18. Email ID registered with Income Tax
19. Given parameter [name, dob, address]
20. Match Score
21. belongs to a `Sole Proprietor [ True or False ]
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response

21. Whether Match is Positive/Valid


22. PAN of the Authorized Signatory
23. Name of the Authorized Signatory
24. First Name of the Authorized Signatory
25. Middle Name of the Authorized Signatory
26. Last Name of the Authorized Signatory
27. Gender of the Authorized Signatory
28. Whether an Aadhaar is linked to the Authorized Signatory's PAN
29. Date of Birth of the Authorized Signatory
30. Mobile No of the Authorized Signatory
31. Email ID of the Authorized Signatory
1. PAN of the Individual / Entity 32. Address Details of the Authorized Signatory as per Income Tax Records
5 Fetch PAN linked details
2. Consent-Y/N 33. House Number/Building details
34. Address Locality
35. Street Location as on the Address
36. Pincode as on the Address
37. City as on the Address
38. State as on the Address
39. Country as on the Address
40. Status of the PAN [Active or Inactive]
41. PAN Card Issue date
42. Whether given PAN belongs to Salaried individual [ True or False ]
43. Whether given PAN belongs to a Director of organization [ True or False ]
44. Whether given PAN belongs to a Sole Proprietor [ True or False ]
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response

1. Registered Address of the Entity


2. Banking details linked with IEC
3. PAN Based BIN Number corresponding to the IEC
4. Complete address of the branch
5. Branch code as per DGFT records
6. Date of establishment as disclosed to DGFT
7. Address of the director or signatory
8. Contact number of the director or signatory
9. Name of the director or signatory
10.Father's Name of the director or signatory
11.Registered email id of the entity
12.Exporter Type registered with DGFT
13.Date of application filing with DGFT
1. Import Export
Fetch Import- Export 14.IEC Code Application file number as per DGFT Records
6 Code
Details 15.Given IEC Code
2. Consent-Y/N
16.IEC Allotment date
17.Current status of IEC as per DGFT Records. Expected Values are - Cancelled, Deactivated, Suspended, Valid, Seize to Exist, Withdrawn from Blacklist
18.IEC Status of the entity. Expected Values are - NORMAL, BLACK LISTED, SUSPENDED, CANCELLED, CLEAR FROM BLACK LIST, REVOKE SUSPENSION, REVOKE CANCELLATION, AMENDMENT
19.Registered name of the entity
20.Legal status of the registered entity
21.Total Number of branches linked to the IEC
22.PAN Number of the Entity
23.Date of PAN Issue
24.PAN issuing department
25.Registered name and address of the Entity
26.Registered contact numbers of the entity
27.Details of Statutory Registrations with other Government Departments linked with IEC
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Registered category of the establishment
2. Current status of registration
3. Name of the owner of the establishment
4. Registered name of the establishment
5. Date of registration under the Shop & Est Act
1. Shop & Establishment
6. Expiry date of registration
Registration Number to
7. Contact number of the business/owner
Establishment be authenticated
8. Date of commencement of the establishment
7 registration details - 2. Code of the jurisdiction
9. Total number of workers (declared) in the establishment
Municipal Authorities of registration, refer
10. Nature of business/activity
notes below
11. Registered address of the establishment
3. Consent-Y/N
12. Effective date of registration
13. Registered Email ID of the establishment (if any)
14. Registered website URL of the establishment (if any)
15. Name of the person/entity who/that filed the application for registration
16. Name of the father of the owner of the business
1. Registration number provided by the registrar
2. Application id of the firm
3. Name of the firm
4. Name of the person/entity that filed the application for registration
5. Date of registration of the firm
6. Year of registration of the firm
7. Registered address of the firm
8. Registered email id of the firm
9. Registered contact number of the firm
10. Registered PAN of the firm
11. Current status of registration (active, approved, pending etc..)
12. Nature of business (manufacturing, construction etc..)
1. Registration number
13. Category of business activity
provided by the registrar
Firm Registration 14. Registered constitution of the firm
8 2. State of registration of
details 15. Type of the project
the firm
16. Type of dealer
3. Consent-Y/N
17. Date of last record updated of firm
18. Expiry date of registration of firm
19. State of registration of the firm
20. District details of the firm
21. Tehsil details of the firm
22. Premises details of the firm's branch
23. City details of the firm
24. Office area of the firm's premises (square foot)
25. Ward details of the firm
26. Branch details of the firm
27. Declared amount of investment by the owners in the partnership firm
28. Central sales tax and tax identification number of the firm
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Email ID of the registered entity linked with the GSTIN
2. Current status of application under GST (MIG = Migrated, DFT = Activated etc.)
3. Mobile Number of the registered entity linked with the GSTIN
4. PAN Number of the registered entity
5. Unique GST application reference ID
Fetch all GSTINs 1. PAN to be authenticated
9 6. Registration Type under GST (V=VAT, S=Service Tax)
details by PAN 2. Consent-Y/N
7. GSTIN Status (Active/Inactive)
8. Unique 15-character GSTIN corresponding to the given tin
9. Registered Name of the entity as per GST
10. Old VAT or Service Tax Tin associated with the GSTIN

1. Fifteen-character unique GSTIN


2. Delay in GST returns filing
3. Default in GST returns filing
4. Validity
5. Mode of Filing
6. Date of Filing
7. Return Type
1. Fifteen-character 8. Return Period
unique GSTIN 9. Application Reference Number
10 GSTIN return details 2. Financial year to 10. Filing Status
which returns pertain 11. Due Date of filing Return
to 12. Whether there is a delay in filing
13. Number of days of delay in filing the particular return
14. Financial year to which returns pertain to
15. Starting month of the quarter
16. Ending month of the quarter
17. Filing frequency for the quarter
18. Quarter pertaining to the Financial Year
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response

1. Email ID - internal database


2. Mobile number-internal database
3. Name-internal database
4. Compliance rating if provided by GSP
5. Registration date under GST
6. Trade Name
7. Nature of business registered under GST
8. Member names if provided by GSP
9. Address-additional places of business
10. Nature of business carried out at the address
11. Address
12. Email id-additional places of business
13. Last updated date of the address
14. Mobile number-additional places of business
15. Address -principal place of business
16. Nature of business carried out at the address
17. Complete Address-principal place of business
18. Email ID-principal place of business
19. Last updated date of this address
20. Mobile Number-principal place of business
21. State Jurisdiction Code
22. Last Updated
23. Given GSTIN
24. Central Jurisdiction Code
1. GSTIN 25. State Jurisdiction
11 GSTIN profile
2. Consent-Y/N 26. Taxpayer Type
27. Date of Cancellation of Registration
28. Constitution of Business (proprietorship, partnership, private limited company, public limited company etc.)
29. Current status of registration under GST
30. Legal Name of the Business or Individual corresponding to the GSTIN
31. Central Jurisdiction
32. HSN details for Goods
33. Description of goods
34. HSN Code for goods
35. Sub-Industry
36. Industry
37. SAC details for services
38. SAC code for services
39. Description of services
40. Aggregated annual PAN level turnover slab of the entity
41. Whether E-Invoice is mandatory for the entity - Yes or No
42. Nature Of Core Business Activity [Manufacturer (MFT) / Trader - Retailer (TRD:TRR) / Trader - Wholesaler/Distributor (TRD:TWD) / Service Provider and Others (SPO)]
43. Whether Aadhaar authenticated
44. Gross total income pertaining to the financial year
45. Whether e-KYC verified
46. Percentage of tax payment in cash
47. Whether compliance details available
48. Gross total income as per income-tax returns (from CBDT database)
49. Aggregated annual PAN level turnover slab of the entity pertaining to the financial year
50. Percentage of tax payment in cash pertaining to the financial year
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Company Identification Number / Limited Liability Partnership Identification Number
2. Active Compliance Status of the Entity
3. Entity's Activity Class
4. Activity Group of the Entity
5. Activity Sub Class Details
6. Alternate Address of the Entity
7. Authorized Capital Amount
8. Category of the Entity
9. Charges Details
10. Charge identification number
11. Service Request Number
12. Status of charge
13. Charge holder name
14. Standardized charge holder name
15. Type of charge holder
16. Charge amount
17. Address of charge holder
18. Assets under charge
19. Date of creation
1.CIN/LLPIN/PAN 20. Date of modification
12 Company profile
2.Consent-Y/N 21. Date of satisfaction
22. Charge holder tag
23. CIRP Status
24. Class
25. Date when the company was struck off under section 248
26. Last updated date when the company was struck off under section 248
27. Source of the information regarding company struck off under section 248
28. Subsection of section 248 under which company is stroked off
29. Country of incorporation
30. Date of annual return filed
31. Date of balance sheet
32. Date of incorporation
33. Date of last AGM
34. Date of statement of accounts and Solvency filed in case of LLP
35. Description of main division in case of an LLP
36. Director details
37. Director identification number
38. PAN of the director
39. Name
40. Designation
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
41. Date of appointment
42. Tenure begin date
43. Tenure end date
44. Last updated date for dormant status
45. Source for the dormant status
46. Email
47. Email domain
48. Foreign company with share capital
49. Former businesses
50. Former director details
51. Director identification number
52. PAN
53. Name
54. Designation
55. Date of appointment
56. Tenure begin date
57. Tenure end date
58. Former entity IDs
59. Former names
1.CIN/LLPIN/PAN 60. Industry
12 Company profile 2.Consent-Y/N 61. Whether the address quality is poor
62. Whether the charge is closed at ARC (data not available anymore)
63. Whether the charge is closed at SASF (data not available anymore)
64. Whether the charge is open at ARC (data not available anymore)
65. Whether the charge is open at SASF (data not available anymore)
66. Whether the company is active non-compliant
67. Whether the company is struck off
68. Whether the company is struck off under section 248
69. Whether the company is under CIRP
70. Whether the company is under liquidation
71. Whether the company is under strike off process
72. Whether the domain invalid
73. Whether the company is dormant
74. Whether the email is disposable
75. Whether the email is invalid
76. Whether the company former directors are PEP
77. Whether LLP is struck off under Rule 37
78. Whether the company is reported by MCA as Defaulter Company for the years 2015 & 2016, for not filing Balance Sheet Forms or other irregularities.
79. Whether the company is multi-level marketing company
80. Whether the company has not filed 5inv
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
81. Whether the company directors are PEP
82. Whether the company is shell company
83. Whether the company is suspended at stock exchange
84. Whether it is a vanishing company as per MCA
85. Listing status
86. Order Date when LLP was struck off under Rule 37
87. Source for information indicating LLP is struck off under Rule 37
88. Main division of business activity in case of an LLP
89. Company defaults
90. Company defaults last updated on
91. Source of company default data
92. Company defaulter years
93. Last updated date for company reported as MLM
94. Source for company reported as MLM
95. Name of the company or LLP
96. Last updated date for company not having filed 5inv form
97. Source of info for company not having filed 5inv form
98. Number of authorized representatives
99. Number of designated partners in case of LLP
100. Number of members
101. Number of partners in case of LLP
1.CIN/LLPIN/PAN 102. Office details
12 Company profile
2.Consent-Y/N 103. Paid up capital
104. PAN
105. Registered address
106. Registration number
107. ROC code
108. Last updated when company was reported as shell
109. Remarks in case of company is shell
110. Source of info for company being reported as shell
111. Source URL
112. Status
113. Sub industry
114. Sub category
115. Timestamp
116. Total obligation of contribution in case of LLP
117. Type
118. Type of office
119. Vanishing FIR status
120. Last updated when company was reported as vanishing
121. Section under which company was reported as vanishing
122. Source of information for company being reported as vanishing
123. Vanishing status
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Building name
2. Latest date of delay
3. Domain
4. TAN status
5. Tax Deduction and Collection Account Number
6. Category
7. Whether TAN is active
8. Area code
9. Dispatch status
10.Whether email id is valid
11.List of Email ID's
12.Range code
13.Branch
14.Whether email id is disposable
15.Whether there is any default in TAN transaction
13 Fetch TAN Details CIN/ DIN/ PAN
16.Permanent account number
17.Latest date of default
18.Assessing officer number
19.Time stamp
20.Deductor category
21.Division name
22.Address
23.Whether domain is invalid
24.Whether address quality is poor
25.Whether there is any delay in TAN transaction
26.Assessing officer description
27.Name of entity
28.Assessing officer type
29.Subcategory
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response

1. MSME Status, values will be Yes or No


2. Block
3. Building
4. City
5. District
6. Flat
7. Email
8. Email domain
9. Contact
10.Pincode
11.Road
12.State
13.Village
14.Masked Contact
15.Date of commencement of production/business
14 MSME Details UDYAM Registration number/CIN/ PAN 16.Date of incorporation
17.Date of registration
18.District Industries Centre
19.Array Containing Enterprise Type Details
20.Type of Enterprise
21.Date of Classification
22.Data Year
23.Year of Classification
24.Full Address of the Entity
25.gender
26.Whether Application is Complete
27.Major activity of the business (Services, Manufacturing)
28.MSME Development and Facilitation Office
29.MSME Development Institute
30.Name of the entity
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response

31. NIC code


32. Industry
33. Date
34. Sub industry code
35. Sub industry
36. Activity class code
37. Activity class
38. Activity sub class code
39. Activity sub class
40. Organization type (Proprietary, Partnership, Private Limited Company, Self Help Group, Limited Liability Partnership, Hindu Undivided Family, Public Limited
Company, Society, Trust, Co-Operative, Others)
41. Social category (General, OBC, SC, ST)
14 MSME Details UDYAM Registration number/ CIN/PAN 42. Type of business (Small, Micro, Medium)
43. Unit details if any
44. Unit name
45. Village/Town
46. Block
47. Building
48. City
49. District
50. Flat
51. Pincode
52. Road
53. State
54. Udyam Registration Number

*In case entity is not MSME, no response will be shown


KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. KYC Company Id
2. CIN Number
3. Company Name
4. Registration Date
Search Company By 1. Company Name
15 5. Time of Creation
Name 2. Consent-Y/N
6. Created By
7. Time of Updation
8. Updated By
9. Time of Deletion

1. PAN number of the Specified Person


2. Compliance status of the pan holder [ Y-ITR is filled hence no double TDS applied for PAN holder/ N-ITR not filed hence double TDS applicable for PAN holder ]
206AB Compliance 1. PAN of the Specified Person
16 3. PAN allotment date as per source
Status 2. Consent-Y/N
4. Pan Aadhaar link status (true/false/null)
5. Status of the PAN (Operative / inoperative / null)

CIN/LLPIN/PAN/DIN/GSTIN/TAN/IEC/LIN/L
17 Entity Linked details 1. Refer attached excel
EI/Establishment ID
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Whether GST is cancelled
2. PAN type
3. Date of registration
4. Centre jurisdiction code
5. Whether domain in valid
6. Composition opt out date
7. Legal name
8. Composition opt date
9. Source
10.Whether field visit is conducted
11.contact
12.TIN
13.Transaction details
14.Dealer type
15.Permanent account number
16.GST cancelled suo moto
17.Core business activity
18.State
19.Constitution of business
Fetch GST profile 1. CIN, LLPIN, PAN 20.Whether GST is under cancellation
18
details 2. Consent-Y/N 21.Aggregate turnovers
22.Whether there is any delay in GST transaction
23.Nature of trade
24.branches
25.Compliance rating
26.Signatories contact
27.Whether email is invalid
28.e-invoice status
29.Services details
30.SAC codes
31.Date of registration/cancellation
32.Signatories
33.Email domain
34.Whether GST is inactive
35.Mandated e-invoice
36.Filing Frequencies
37.financial Year
38.Frequency
39.Quarter
40.Preference
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
41. Whether there is more additional place of business
42. Nature of business
43. State jurisdiction code
44. Goods and Services Tax Identification Number
45. Whether e-KYC is verified
46. State abbreviation
47. Aggregate turnovers
48. Trade name
49. Date of VAT Registration
50. Address
51. Whether email is disposable
52. Email id
53. Time stamp
54. Details of transaction delays
Fetch GST profile 1. CIN, LLPIN, PAN
18 55. Address
details 2. Consent-Y/N
56. Details of goods
57. Whether there is any default in GST transaction
58. State code
59. Tax payments in cash
60. Message
61. Whether GST is provisional
62. Gross Total Incomes"
63. Last updated date
64. Centre jurisdiction code
65. Whether address quality is poor
66. Whether Aadhaar is authenticated
67. Date of e-KYC
68. GST suspended
69. State jurisdiction
1. Bank Transaction Status
2. Provided account number
3. Provided IFSC code
4. Name of the account holder
5. Bank response for the transaction
6. Bank RRN for the transaction
1. Account number to be verified. 7. Internal Status Code that denotes the status of the request.
2. IFSC code of the home branch of the 8. Validity Status
19 Bank account details
account. 9. Identification of the transaction processed through framework (NON_PENNY OR PENNY)
3. Consent-Y/N 10. Comparison Data
11. Comparison of Input vs Source data
12. Flags from Comparison data
13. Comparison Results against Account Holder Name
14. Name Match Score
15. Name Match Result
16. Validity Status as per comparison
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Master profile of the Company
2. Email ID of the Entity
3. Company Identification Number of the Entity
4. Registered Address of the Entity
5. Registration date of the Entity
6. Registered Name of the Entity
7. Annual Return data
8. List Of Subsidiaries of the Entity
9. Percentage Of Shares Held
10.Company Identification Number or Foreign Company Identification Number
11.Name of the Subsidiary
1. CIN 12.Whether Holding / Subsidiary / Associate / Joint Venture
20 Primary Business 2. Consent-Y/N 13.Business Activities List
3. Financial year 14.Percentage Of Turnover Of The Entity
15.Description Of Main Activity Group
16.Business Activity Code
17.Description Of Business Activity
18.Main Activity Group Code
19.List Of Foreign Investors
20.Name
21.Date Of Incorporation
22.Numbers Of Shares Held
23.Country Of Incorporation
24.Address
25.Percentage Of Shares Held
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. GSTIN Number
2. True | false implying if the registration status is active
3. PAN number as extracted from GSTIN.
4. Date of GSTIN registration DD-MM-YYYY
5. Name of entity as registered in GST database
6. Business / trade name as registered in GST database
7. Status of GST registration, Active, Cancelled etc.
8. Regular etc.
9. Constitution type such as private limited, proprietorship etc.
10. Primary registered address of the company.
11. Type of address
12. Building, house, plot number
Fetch All GSTIN Details 1. PAN 13. Name of the premises
21
PAN V2 2. Consent-Y/N 14. Floor number in the building
15. Name of the street
16. Local area name
17. District name
18. City name
19. State name
20. Pincode of the location
21. Latitude of the location
22. Longitude of the location
23. Business purpose for which this address is used
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Name of the account holder as per bank records
2. IFSC details for the ifsc code entered. Available only if fetchIfsc is passed as true. The structure of object is same as specified in IFSC Validation API response.
IFSC validation service must be enabled in your account to use this option.
3. True | false if the provided account and ifsc combination is valid, account exists and is active
4. Bank Name
5. Bank code
6. IFSC details for the ifsc code entered.
7. MICR
1. Bank Account Number 8. Branch Name
2. IFSC code of the bank branch 9. City
Bank Account
22 3. Fetch IFSC details for the ifsc 10. District
Verification V2.0
provided 11. State
4. Consent-Y/N 12. Address
13. NEFT Number
14. IMPS
15. RTGS
16. A status code describing the reason if valid is false. values. ACTIVE, INVALID, BLOCKED,CLOSED, NRE, INVALID_IFSC
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Valid
2. Udyam registration number
3. MSME name as registered
4. Type of the entity. Proprietary, Partnership, Public Limited, Private Limited etc.
5. Major activity of the unit. Manufacturing or Services
6. Gender of the owner as registered. Male, Female or Others.
7. Social category of the owner as registered. General, SC, ST, OBC.
8. Date of incorporation of MSME
9. Date of commencement of operations if commenced
10. Date of MSME registration
11. List of MSME classifications such as Micro, Small or Medium and corresponding effective dates. See MSME Classification Object below for the details.
12. Date since effective
13. Financial year for which the classification is effective
14. Category Micro, Medium or Small
15. Plant/unit locations as registered. See MSME Location Object below for details.
16. Name of the plant / unit
17. House, plot or unit number
18. Building name of the plan location
19. Village or town name of the plant location
20. Block / area name of the plant location
21. Name of the road
22. City name of the plant location
1. UDYAM number
23 MSME Details V2 23. Pin code of the plant location
2. Consent – Y/N
24. State where plant is located
25. District name where plant is located
26. The official registered address of the enterprise. See MSME Address Object below for the details.
27. House, plot or unit number
28. Name of the building
29. Name of the village or town
30. Block or area name
31. Name of the road
32. Registered official address city
33. State name
34. Name of the district
35. Pin code of the location
36. Masked registered email of the enterprise owner
37. Masked registered mobile of the enterprise owner
38. List of National industrial classification (NIC) codes for the activities performed by this enterprise. See MSME NIC Code Object
39. 2 Digit NIC code and description
40. 4 Digit NIC code and description
41. 5 Digit NIC code and description
42. Type of activity
43. Effective date
44. Name of the district industry centre (DIC) where registered
45. Development and Facilitation office (DFO) location
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. Registration No of the company (CIN / LLPIN / FCRN / FLLPIN)
2. Name of entity as registered in MCA database
3. ROC office code where entity is registered
4. Unique registration number assigned to the entity
5. Entity category such as entity listed by shares etc.
6. Subcategory such as Non-govt company etc.
7. Public / private
8. Authorized max amount of shares
9. Paid up capital
10. Date of registration / incorporation of the entity
11. List of all associated addresses
12. Type of the address - Registered Address, Annual Return Address, Book Address etc.
13. Line 1 of the address
14. Line 2 of the address
15. Line 3 of the address
16. Line 4 of the address
17. Locality name
18. District where located
19. City name
1. CIN 20. Name of the state
24 Company Profile V2
2. Consent-Y/N 21. Country
22. Pin code of the address
23. Type of office
24. Whether current address or past address
25. Date of establishment at this address if available
26. Complete address in one line
27. Email address of the company
28. Boolean flag which indicates if the company is listed in share market.
29. Date of last annual general meeting DD-MM-YYYY
30. Balance sheet last updated date DD-MM-YYYY
31. Boolean flag indicating if the company status is active
32. Number of partners registered in the company. Available only for limited liability partnership entities.
33. Number of designated partners
34. Past name of the entity is available
35. Total Obligation of contribution for the entity
36. Industry type or category of business
37. Section with in the industry division
38. Country name for the foreign registered entities
39. Foreign entity with share capital
40. Office type for foreign entities
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response

41. Company type


42. Registration type
43. Status of the company as registered with MCA
44. Form INC22A filed status
45. Strike off / Amalgamation / Transfer date
46. RD office where registered
47. Region name
48. Flag indicating if suspended at stock exchange
49. Insolvency Status if applicable
50. Subscribed capital
51. List of directors / signatories associated
52. DIN
53. PAN Number
54. First Name
1. CIN 55. Middle Name
24 Company Profile V2
2. Consent-Y/N 56. Last Name
57. Appointment Date
58. Disqualified
59. Role
60. Role Effective Date
61. Role Cessation Date
62. Designation
63. Designation Effective Date
64. Is Current Signatory
65. Type
66. Index of charges
67. SRN Number
68. Charge Id
69. Charge Holder
70. Charge Holder Address
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
71. Charge Holder Address
72. Line 1 of the address
73. Line 2 of the address
74. Line 3 of the address
75. Line 4 of the address
76. Locality
77. District
78. City name
79. State name
80. Country name
1. CIN 81. ZIP Code
24 Company Profile V2
2. Consent-Y/N 82. Full Address
83. Amount
84. Created Date
85. Modified Date
86. Satisfied Date
87. Charge Status
88. Array of filings made by the company
89. SRN Number
90. E-Form
91. Filed
92. Description

1. PAN 1. CIN
25 Fetch CIN by PAN
2. Consent – Y/N 2. Name of the company / LLP
KYC APIs - Request & Response – Direct API Integration
S.no API name Request Response
1. True | false depending on if provided PAN number exists and is valid
2. Category of the taxpayer
1. PAN
26 PAN Verification V2.0 3. name of the permanent account number holder
2. Consent-Y/N
4. Flag indicating whether PAN is linked to Aadhaar.

1. Aadhar Issued ?
2. Address
Aadhaar Number 1. Aadhar Number 3. Age Band
27
Verification V2 2. Consent – Y/N 4. Gender
5. Masked Mobile Number
KYC APIs – Request and Response – Managed Services
KYC APIs - Request & Response – Managed Services
S.no API name Request Response
1. Status-Active/Inactive
1. PAN to be authenticated
1 Fetch PAN details 2. Name
2. Consent-Y/N
3. Date Of Birth
1. PAN
2 Fetch PAN Holder Name 1. Complete name of the PAN holder
2. Consent-Y/N

1. Validity
2. Category of the taxpayer
3 PAN verification V2 1. PAN Number to be authenticated
3. Name
4. Aadhaar Linked Status

1. Masked Mobile number (last 3 digits shown) linked with the Aadhaar
1. 12- digit Aadhaar Card Number 2. Gender as on Aadhaar
4 Aadhaar Number Verification
2. Consent-Y/N 3. State registered as on Aadhaar
4. Age band of the user as on Aadhaar

1. PAN of the Individual/Entity


2. Status of the PAN [Active or Inactive]
3. PAN Card Issue date
4. Full Name of the Individual/Entity as per Income Tax Records
5. First Name of the Individual
6. Middle Name of the Individual
1. PAN of the Individual / Entity 7. Last Name of the Individual
5 Fetch PAN linked details
2. Consent-Y/N 8. Gender of the Individual (Not Applicable for Entity PAN)
9. Whether an Aadhaar is linked to the PAN (Not Applicable for Entity PAN)
10. Whether given 4 digits of aadhaar match with last four digits as per Income Tax Records (Not Applicable for Entity PAN)
11. Date of Birth/Incorporation as per Income Tax Records
12. Whether given PAN belongs to Salaried individual [ True or False ]
13. Whether given PAN belongs to a Director of organization [ True or False ]
14. Whether given PAN belongs to a Sole Proprietor [ True or False ]
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

1. Registered name of the entity


2. Registered Address of the Entity
3. PAN Based BIN Number corresponding to the IEC
4. Date of establishment as disclosed to DGFT
5. Registered email id of the entity
6. Exporter Type registered with DGFT
1. Import Export
Fetch Import- Export 7. Date of application filing with DGFT
6 Code
Details 8. IEC Code Application file number as per DGFT Records
2. Consent-Y/N
9. Current status of IEC as per DGFT Records. Expected Values are - Cancelled, Deactivated, Suspended, Valid, Seize to Exist, Withdrawn from Blacklist
10.IEC Status of the entity. Expected Values are - NORMAL, BLACK LISTED, SUSPENDED, CANCELLED, CLEAR FROM BLACK LIST, REVOKE SUSPENSION, REVOKE CANCELLATION, AMENDMENT
11.Legal status of the registered entity
12.Total Number of branches linked to the IEC
13.PAN of the Entity
KYC APIs - Request & Response – Managed Services
S.no API name Request Response
1. Registered category of the establishment
2. Current status of registration
3. Name of the owner of the establishment
4. Registered name of the establishment
5. Date of registration under the Shop & Est Act
1. Shop & Establishment 6. Expiry date of registration
Registration Number to 7. Contact number of the business/owner
Establishment be authenticated 8. Date of commencement of the establishment
7 registration details - 2. Code of the jurisdiction 9. Total number of workers (declared) in the establishment
Municipal Authorities of registration, refer 10. Nature of business/activity
notes below 11. Registered address of the establishment
3. Consent-Y/N 12. Effective date of registration
13. Registered Email ID of the establishment (if any)
14. Registered website URL of the establishment (if any)
15. Name of the person/entity who/that filed the application for registration
16. Name of the father of the owner of the business
17. Link to open the certificate for Telangana and Karnataka
1. Registration number provided by the registrar
2. Name of the firm
3. Name of the person/entity that filed the application for registration
4. Date of registration of the firm
5. Year of registration of the firm
6. Registered address of the firm
7. Registered email id of the firm
8. Registered contact number of the firm
9. Registered PAN of the firm
10. Current status of registration (active, approved, pending etc..)
11. Nature of business (manufacturing, construction etc..)
12. Category of business activity
1. Registration number
13. Registered constitution of the firm
provided by the registrar
Firm Registration 14. Type of the project
8 2. State of registration of
details 15. Type of dealer
the firm
16. Date of last record updated of firm
3. Consent-Y/N
17. Expiry date of registration of firm
18. State of registration of the firm
19. District details of the firm
20. Tehsil details of the firm
21. Premises details of the firm's branch
22. City details of the firm
23. Office area of the firm's premises (square foot)
24. Ward details of the firm
25. Branch details of the firm
26. Declared amount of investment by the owners in the partnership firm
27. Central sales tax and tax identification number of the firm
28. Serial Number
KYC APIs - Request & Response – Managed Services
S.no API name Request Response
1. Email ID of the registered entity linked with the GSTIN
2. Current status of application under GST (MIG = Migrated, DFT = Activated etc.)
3. Mobile Number of the registered entity linked with the GSTIN
4. PAN Number of the registered entity
5. Unique GST application reference ID
Fetch all GSTINs 1. PAN to be authenticated
9 6. Registration Type under GST (V=VAT, S=Service Tax)
details by PAN 2. Consent-Y/N
7. GSTIN Status (Active/Inactive)
8. Unique 15-character GSTIN corresponding to the given tin
9. Registered Name of the entity as per GST
10. Old VAT or Service Tax Tin associated with the GSTIN

1. Delay in GST returns filing


2. Default in GST returns filing
3. Validity
4. Mode of Filing
5. Date of Filing
6. Return Type
7. Return Period
8. Application Reference Number
1. Fifteen-character
9. Filing Status
10 GST return details unique GSTIN
10. Due Date of filing Return
2. Consent -Y/N
11. Whether there is a delay in filing
12. Number of days of delay in filing the particular return
13. Financial year to which returns pertain to
14. Starting month of the quarter
15. Ending month of the quarter
16. Filing frequency for the quarter
17. Quarter pertaining to the Financial Year
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

1. GSTIN
2. E-Invoice Applicability
3. GSTN Status
4. Compliance rating
5. Registration date under GST
6. Trade Name
7. Taxpayer Type
8. Date of Cancellation of Registration
1. GSTIN 9. Constitution of Business
11 GSTIN profile
2. Consent-Y/N 10. Whether Aadhaar authenticated
11. Gross total income pertaining to the financial year
12. Whether e-KYC verified
13. Percentage of tax payment in cash
14. Whether compliance details available
15. Gross total income as per income-tax returns (from CBDT database)
16. Aggregated annual PAN level turnover slab of the entity pertaining to the financial year
17. Percentage of tax payment in cash pertaining to the financial year
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

1. Active Compliance Status of the Entity


2. Entity's Activity Class
3. Activity Group of the Entity
4. Activity Sub Class Details
5. Alternate Address of the Entity
6. Authorized Capital Amount
7. Category of the Entity
8. Date when the company was struck off under section 248
9. Last updated date when the company was struck off under section 248
10. Source of the information regarding company struck off under section 248
11. Country of incorporation
12. Date of annual return filed
13. Date of balance sheet
14. Date of incorporation
15. Date of last AGM
1.CIN/LLPIN/PAN
12 Company profile 16. Date of statement of accounts and Solvency filed in case of LLP
2.Consent-Y/N
17. Last updated date for dormant status
18. Source for the dormant status
19. Foreign company with share capital
20. Whether the company is struck off
21. Whether the company is struck off under section 248
22. Whether the company is under CIRP
23. Whether the company is under liquidation
24. Whether the company is under strike off process
25. Whether the company is dormant
26. Whether LLP is struck off under Rule 37
27. Whether the company is shell company
28. Whether the company is suspended at stock exchange
29. Whether it is a vanishing company as per MCA
30. Listing status
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

31. Order Date when LLP was struck off under Rule 37
32. Source for information indicating LLP is struck off under Rule 37
33. Main division of business activity in case of an LLP
34. Company defaults
35. Company defaulter years
36. Last updated date for company reported as MLM
37. Source for company reported as MLM
38. Name of the company or LLP
39. Number of authorized representatives
40. Number of designated partners in case of LLP
41. Number of members
42. Number of partners in case of LLP
1.CIN/LLPIN/PAN 43. Office details
12 Company profile
2.Consent-Y/N 44. Paid up capital
45. PAN
46. Registered address
47. Registration number
48. ROC code
49. Last updated when company was reported as shell
50. Source of info for company being reported as shell
51. Vanishing FIR status
52. Last updated when company was reported as vanishing
53. Section under which company was reported as vanishing
54. Source of information for company being reported as vanishing
55. Vanishing status
KYC APIs - Request & Response – Managed Services
S.no API name Request Response
1. Building name
2. Latest date of delay
3. Domain
4. TAN status
5. Tax Deduction and Collection Account Number
6. Category
7. Whether TAN is active
8. Area code
9. Dispatch status
10.Whether email id is valid
11.Range code
12.Branch
13.Whether there is any default in TAN transaction
14.Permanent account number
13 Fetch TAN Details CIN/ DIN/ PAN
15.Latest date of default
16.Assessing officer number
17.Time stamp
18.Deductor category
19.Division name
20.Address
21.Whether domain is invalid
22.Whether address quality is poor
23.Whether there is any delay in TAN transaction
24.Assessing officer description
25.Name of entity
26.Assessing officer type
27.Subcategory
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

1. MSME Number
2. MSME Status
3. Name of the Entity
4. Type of the entity
14 MSME Details UDYAM Registration number/CIN/ PAN 5. Classification type
6. Date of commencement of operations
7. Date of incorporation of MSME
8. Date of MSME registration
9. District Industries Centre
10.Major activity of the business

Search Company By 1. Company Name 1. CIN Number


15
Name 2. Consent-Y/N 2. Company Name

1. PAN number of the Specified Person


2. Compliance status of the pan holder [ Y-ITR is filled hence no double TDS applied for PAN holder/ N-ITR not filed hence double TDS applicable for PAN holder
206AB Compliance 1. PAN of the Specified Person
16 3. PAN allotment date as per source
Status 2. Consent-Y/N
4. Pan Aadhaar link status (true/false/null)
5. Status of the PAN (Operative / inoperative / null)

1. Bank Transaction Status


2. Provided account number
3. Provided IFSC code
4. Name of the account holder
1. Account number to be verified.
5. Bank response for the transaction
2. IFSC code of the home branch of the
17 Bank account details 6. Bank RRN for the transaction
account.
7. Validity Status
3. Consent-Y/N
8. Identification of the transaction processed through framework (NON_PENNY OR PENNY)
9. Name Match Score
10. Name Match Result
11. Validity Status as per comparison
KYC APIs - Request & Response – Managed Services
S.no API name Request Response
1. Registration No of the company
2. Name of entity as registered in MCA database
3. ROC office code where entity is registered
4. Unique registration number assigned to the entity
5. Entity category
6. Sub category
7. Class Type
8. Authorized Capital
9. Paid Capital
10.Incorporated Date
11.List of all associated addresses
12.Email address of the company
13.Company listed in share market
14.Date of last annual general meeting
15.Balance sheet last updated date
16.Company status active
17.List of directors / signatories associated
18.Index of charges
19.Efilings
CIN
18 Company Profile V2 20.Total Obligation of contribution for the entity
Consent – Y/N
21.Industry Type
22.Industry Section
23.Incorporated Country
24.Share Capital
25.Office Type
26.Company Type
27.Registration Type
28.Status of the company as registered with MCA
29.Form INC22A filed status
30.Strike off / Amalgamation / Transfer date
31.RD office where registered
32.Region Name
33.Suspended at Stock Exchange
34.Insolvency Status if applicable
35.Subscribed capital
36.Number of Partners
37.Number of Designated Partners
38.Past name of the entity
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

1. PAN 1. CIN
19 Fetch CIN by PAN
2. Consent – Y/N 2. Name of the company / LLP

1. Udyam registration number


2. MSME name as registered
3. Type of the entity. Proprietary, Partnership, Public Limited, Private Limited etc.
4. Major activity of the unit. Manufacturing or Services
5. Gender of the owner as registered. Male, Female or Others.
6. Social category of the owner as registered. General, SC, ST, OBC.
7. Date of incorporation of MSME
8. Date of commencement of operations if commenced
9. Date of MSME registration
10. List of MSME classifications such as Micro, Small or Medium and corresponding effective dates. See MSME Classification Object below for the details.
11. Date since effective
12. Financial year for which the classification is effective
1. UDYAM number 13. Category Micro, Medium or Small
20 MSME Details V2
2. Consent – Y/N 14. Plant/unit locations as registered. See MSME Location Object below for details.
15. Name of the plant / unit
16. House, plot or unit number
17. Building name of the plan location
18. Village or town name of the plant location
19. Block / area name of the plant location
20. Name of the road
21. City name of the plant location
22. Pin code of the plant location
23. State where plant is located
24. District name where plant is located
25. The official registered address of the enterprise. See MSME Address Object below for the details.
KYC APIs - Request & Response – Managed Services
S.no API name Request Response

26. House, plot or unit number


27. Name of the building
28. Name of the village or town
29. Block or area name
30. Name of the road
31. Registered official address city
32. State name
33. Name of the district
34. Pin code of the location
1. UDYAM number
35. Masked registered email of the enterprise owner
20 MSME Details V2 2. Consent – Y/N
36. Masked registered mobile of the enterprise owner
37. List of National industrial classification (NIC) codes for the activities performed by this enterprise. See MSME NIC Code Object
38. 2 Digit NIC code and description
39. 4 Digit NIC code and description
40. 5 Digit NIC code and description
41. Type of activity
42. Effective date
43. Name of the district industry centre (DIC) where registered
44. Development and Facilitation office (DFO) location
Product related APIs
Product Related APIs
E-GST APIs (User Journey 1)

GSTR 1 Purchase Recon with 2A / 2B GSTR 3B GSTR-9 & 9C GST Ledger


1. Upload & validate outward 1. Upload & validate purchase data 1. Prepare GSTR-3B 1. Fetch auto-generated 1. Fetch Cash Ledger
data GSTR-9 from GSTN
2. Review uploaded invoice data • EGST Outward + EGST Inward 2. Fetch GST ITC Ledger
2. Review uploaded invoice data 2. Prepare GSTR-9
3. Fetch data GSTR 2A & 2B • EGST Outward + 2B 3. Fetch GST Liability
3. Save data to GSTN 3. Review prepared data Ledger
4. Reconciliation via API • GSTN 3B calc Data + EGST
4. Delete data from GSTN Inward 4. Save data To GSTN 4. Fetch running
• Inward vs 2A
balance of GST
5. Generate GSTR-1 Summary • GSTN 3B calc Data + 2B 5. Proceed to File
• Inward vs 2B liability, ITC & cash
6. Proceed to File 2. Review GSTR-3B data 6. File GSTR 9 Return
5. Review reconciliation data
7. File GSTR 1 Return 3. Save data to GSTN 7. Fetch GSTR 9 data for
6. Fetch reconciliation summary
9C
8. Fetch GSTR-1 data 4. Offset- liability on GSTN
7. Remove Record from EGST.
8. Prepare GSTR - 9C
9. Remove record from EGST & 5. File GSTR 3B Return
GSTN (both) 9. Save GSTR - 9C to
6. Fetch filed GSTR 3B data
GSTN

• Including RET API for all above functionalities


For queries regarding our services, please get in touch with us
For any other comments or feedback, kindly write in to [email protected]

Ahmedabad Bengaluru – Office 1 Bengaluru – Office 2 Chandigarh Chennai


Westgate Business Bay, Floor 6 Prestige Nebula, Floor 3 SV Tower, No. 27, Floor 4 Plot no 55, Floor 5 No. 443 & 445, Floor 5, Main Building
Office No 601, Block A, Makarba Infantry Road 80 Feet Road, 6th Block, Koramangala Industrial & Business Park Guna Complex, Mount Road, Teynampet
Ahmedabad, Gujarat 380051, INDIA Bengaluru 560095, INDIA Bengaluru 560095, INDIA Phase 1, Chandigarh 160002, INDIA Chennai 600018, INDIA

Coimbatore Delhi - Office 1 Delhi - Office 2 Goa Hyderabad


Pacom Square, Floor 3, 104/1, Sakthi The Palm Springs Plaza Windsor IT Park, Plot No: A-1 701, Kamat Towers 1101/B, Manjeera Trinity Corporate
Main Road, Bharathi Nagar, Ganapathy Office No. 1501-10, Sector-54 Floor 2, Tower-B, Sector-125 9, EDC Complex, Patto JNTU-Hitech City Road, Kukatpally
Coimbatore, Tamil Nadu – 641 006 Golf Course Road, Gurugram 122001 INDIA Noida 201301, INDIA Panaji, Goa 403001, INDIA Hyderabad 500072, INDIA

Kochi Kolkata Mumbai - Office 1 Mumbai - Office 2 Mumbai - Office 3


XL/215 A, Krishna Kripa Floor 4, Duckback House The Ruby, Level 9, North West Wing 601, Floor 6, Raheja Titanium Floor 20, 2001 & 2002 - A Wing, 2001 - F Wing
Layam Road, Ernakulam 41, Shakespeare Sarani Senapati Bapat Marg, Dadar (W) Western Express Highway, Geetanjali Lotus Corporate Park, Western Express Highway
Kochi 682011, INDIA Kolkata 700017, INDIA Mumbai 400028, INDIA Railway Colony, Ram Nagar, Goregaon (E) Ram Mandir Fatak Road, Goregaon (E)
Mumbai 400063, INDIA Mumbai 400 063, INDIA

Mumbai - Office 4 Pune – Office 1 Pune – Office 2


The Ruby, Level 9, South East Wing Floor 6, Building # 1 Floor 2 & 4, Mantri Sterling, Deep Bunglow
Senapati Bapat Marg, Dadar (W) Cerebrum IT Park, Kalyani Nagar Chowk, Model Colony, Shivaji Nagar
Mumbai 400028, INDIA Pune 411014, INDIA Pune 411016, INDIA

This publication has been carefully prepared, but it has been written in general terms and should be seen as containing broad statements only. This publication should not be used or relied upon to cover specific situations and you should not act, or refrain from acting, upon the information contained in this publication without obtaining
specific professional advice. Please contact BDO India LLP to discuss these matters in the context of your particular circumstances. BDO India LLP, its partners, employees and agents do not accept or assume any responsibility or duty of care in respect of any use of or reliance on this publication, and will deny any liability for any loss
arising from any action taken or not taken or decision made by anyone in reliance on this publication or any part of it. Any use of this publication or reliance on it for any purpose or in any context is therefore at your own risk, without any right of recourse against BDO India LLP or any of its partners, employees or agents.
BDO India LLP, a limited liability partnership, is a member of BDO International Limited, a UK company limited by guarantee, and for-ms part of the international BDO network of independent member firms.
BDO is the brand name for the BDO network and for each of the BDO Member Firms.
Copyright © 2023 BDO India LLP. All rights reserved. Published in India.

Visit us at www.bdo.in

You might also like