APIs List 08 April 24
APIs List 08 April 24
1. PAN
2 Fetch PAN Holder Name 1. Complete name of the PAN holder
2. Consent-Y/N
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
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. 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
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
1. PAN 1. CIN
19 Fetch CIN by PAN
2. Consent – Y/N 2. Name of the company / LLP
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