Query Corporation Cardholder
Retrieve corporation cardholder details by providing either a holder_id or a combination of registration_country and registration_code.
Request URI
POST
/issuing/holder/query-corporation
Request Body
Refer to : common
Biz_data :
holder_id
long
Corporation Holder ID
registration_country
string(2)
Registration Country
registration_code
string(32)
Registration Code
Request Example
{
"app_id": "00000000000000000",
"timestamp": "2025-04-07 13:52:20",
"format": "JSON",
"version": "2.0",
"random_key": "<generated_key>",
"request_id": "4CDA337F-46dE-EA1e-ab88-c19AD5cc",
"sign_type": "RSA",
"biz_data": {
"holder_id": "103007"
},
"partner_id": "00000000000000000",
"sub_partner_id": " "
}
// The biz_data in this example needs to be encrypted!
Response
holder_id*
long
Corporation Holder ID
contact_name*
string
Contact Name
mobile*
string
The whole mobile phone number.
Need to add an international area code
email*
string
corporation.corporation_id*
long
Corporation ID
corporation.registration_name*
string
Registration Name
corporation.registration_code*
string
Registration Code
corporation.registration_date*
string
Registration Date.Format: yyyy-MM-dd
corporation.vat_code
string
VAT Code
corporation.expires_on
string
Expires On.Format: yyyy-MM-dd
corporation.business_scope
string
Business Scope
corporation.registration_address.address_id*
long
Address ID
corporation.registration_address.line*
string
The first line of the address.
corporation.registration_address.line2
string
The second line of the address.
corporation.registration_address.postal_code*
string
The address zip code, or postal code
corporation.registration_address.city_name*
string
The address city
corporation.registration_address.state*
string
The address state
corporation.registration_address.country_code*
string
Country code
person.person_id*
long
Person ID
person.first_name*
string
Director.First Name
person.last_name*
string
Director.Last Name
person.middle_name
string
Director.Middle Name
person.national_name
string
Director.National Name
person.id_no*
string
Director.ID Number
person.birthday*
string
Director.Birthday
person.issuance_date
string
Director.Issuance Date
Format: yyyy-MM-dd
person.expires_on
string
Director.Expires On
Format: yyyy-MM-dd
person.citizenship_country*
string
Director.Citizenship Country
person.address.address_id*
long
Address ID
person.address.line*
string
Director.The first line of the address.
person.address.line2
string
Director.The second line of the address.
person.address.postal_code*
string
Director.The address zip code, or postal code
person.address.city_name*
string
Director.The address city
person.address.state*
string
Director.The address state
person.address.country_code*
string
Director.Country code
create_time
string
Create Time
{
"code": "10000",
"msg": "Success",
"total": 1,
"random_key": "<random key used for decryption>",
"sign_type": "RSA",
"app_id": "00000000000000000",
"data": {
"holder_id": 103007,
"contact_name": "Test User",
"mobile": "+8618102092707",
"email": "[email protected]",
"status": 1,
"corporation": {
"corporation_id": 100817,
"registration_name": "Test User INC",
"registration_code": "360000201510032997",
"registration_date": "2012-12-10",
"vat_code": "vatcode12",
"expires_on": "2032-12-10",
"business_scope": "automation test records",
"registration_address": {
"address_id": 104344,
"city_name": "West Lyda",
"country_code": "MX",
"postal_code": "48162-42",
"state": "Virginia",
"line": "line 1 line 1 line 1 line 1 ",
"line2": "line 2 line 2 line 2 line 2 "
}
},
"person": {
"person_id": 103260,
"last_name": "User",
"first_name": "Test",
"middle_name": null,
"national_name": "rpc",
"gender": 3,
"citizenship_country": "MX",
"birthday": "2021-12-09",
"id_type": 2,
"id_no": "360000200812043160",
"issuance_date": "2012-12-10",
"expires_on": "2032-12-10",
"address": {
"address_id": 104343,
"city_name": "West Ronaldo",
"country_code": "LR",
"postal_code": "37993",
"state": "Tennessee",
"line": "line 1 line 1 line 1 line 1 ",
"line2": "line 2 line 2 line 2 line 2 "
}
},
"create_time": "2025-04-07 05:52:19"
}
}
// The data in this example has already been decrypted.
Last updated
Was this helpful?