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

200:OK

{
    "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": "[phone]",
        "email": "[e-mail]",
        "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.

400: invalid-signature

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}