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 :

Name
Type
Description

holder_id

long

Corporation Holder ID

registration_country

string(2)

Registration Country

registration_code

string(32)

Registration Code

Choose one of holder_id and 【registration_country、registration_code】

Request Example

{
    "app_id": "00000000000000000",
    "partner_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"
    }
}
// The biz_data in this example needs to be encrypted!

Response

Name
Type
Description

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

Email

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_type*

integer

Director.ID Type

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

Last updated

Was this helpful?