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",
    "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

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

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": "z.yrckcialmy@ccdwqo.to",
        "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?