Company Status Inquiry
1. CheckCorpNum - Check a single case
- This API checks the company status of a single case.
CorpState CheckCorpNum(String MemberCorpNum, String CheckCorpNum) throws PopbillException
Parameters
Parameters
| No. | Field | Type | Length | Mandatory | Description |
|---|---|---|---|---|---|
| MemberCorpNum | String | 10 | Y |
Business registration number of a user who inquire a company status
10-digits except (‘-’)
|
|
| CheckCorpNum | String | - | Y | Business registration number to check |
Return
CorpState
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| corpNum | String | 10 |
Business registration Number
10-digits except (‘-’)
|
|
| taxType | String | 2 |
Taxation types
nullunavailable to check
10general
20exempted
30simplified taxpayer
31simplified taxpayer with a tax invoice issuance duty
40nonprofit, government institution, or an organization certified with proper number
|
|
| typeDate | String | 10 |
Date of taxation type change
format: yyyy-MM-dd
|
|
| state | String | 1 |
Company status
nullunavailable to check
0unregistered business
1in business
2closed
3suspended
|
|
| stateDate | String | 10 |
Date of business suspension/closure
format: yyyy-MM-dd
|
|
| checkDate | String | 10 |
Confirmed date of status checking from the NTS
date of checking via POPBiLL system
format: yyyy-MM-dd
|
Throws
PopbillException
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - |
API response code
8 digits code that starts with (‘-’) [Error Code]
|
|
| message | String | - | Error message for any failed API process |
2. CheckCorpNums - Check multiple cases
- This API checks the company status of multiple cases. (Maximum : 1,000 cases)
CorpState[] CheckCorpNum(String MemberCorpNum, String[] CorpNumList) throws PopbillException
Parameters
Parameters
| No. | Field | Type | Length | Mandatory | Description |
|---|---|---|---|---|---|
| MemberCorpNum | String | 10 | Y |
Business registration number of a user who inquire a company status
10-digits except (‘-’)
|
|
| CorpNumList | String[ ] | Y |
Business registration number to check
maximum : 1,000 cases
|
||
Return
CorpState
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| corpNum | String | 10 |
Business registration Number
10-digits except (‘-’)
|
|
| taxType | String | 2 |
Taxation types
nullunavailable to check
10general
20exempted
30simplified taxpayer
31simplified taxpayer with a tax invoice issuance duty
40nonprofit, government institution, or an organization certified with proper number
|
|
| typeDate | String | 10 |
Date of taxation type change
format: yyyy-MM-dd
|
|
| state | String | 1 |
Company status
nullunavailable to check
0unregistered business
1in business
2closed
3suspended
|
|
| stateDate | String | 10 |
Date of business suspension/closure
format: yyyy-MM-dd
|
|
| checkDate | String | 10 |
Confirmed date of status checking from the NTS
date of checking via POPBiLL system
format: yyyy-MM-dd
|
Throws
PopbillException
| No. | Field | Type | Length | Description |
|---|---|---|---|---|
| code | long | - |
API response code
8 digits code that starts with (‘-’) [Error Code]
|
|
| message | String | - | Error message for any failed API process |

