Skip to main content

v2.shop.get_br_shop_onboarding_info

GET /api/v2/shop/get_br_shop_onboarding_info

[For BR Shop Only] Use this API to get shop KYC registration and qualification information.

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/shop/get_br_shop_onboarding_info

Common Request Parameters

NameTypeSampleDescription
partner_idint1Partner ID is assigned upon registration is successful. Required for all requests.
timestamptimestamp1610000000This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_idint600000Shopee's unique identifier for a shop. Required param for most APIs.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

No Request Parameters Set.

Response Parameters

NameTypeSampleDescription
errorstringIndicate error type if hit error. Empty if no error happened.
messagestringIndicate error details if hit error. Empty if no error happened.
request_idstring6745b892295d750abf83a29430510400The identifier for an API request for error tracking.
responseobjectOnboarding information of the Shop.
tax_id_typeint32Type of the shop’s tax ID. Applicable values: 1: Personal seller (CPF) 2: Company seller (CNPJ)
tax_idstringThe shop’s tax ID. - When tax_id_type = 1 (Personal seller), it is CPF. - When tax_id_type = 2 (Company seller), it is CNPJ.
cpf_idstringCPF number of the individual seller. Valid only when tax_id_type = 1.
cnpj_idstringCNPJ number of the company seller. Valid only when tax_id_type = 2.
namestringFull name of the individual seller. Valid only when tax_id_type = 1.
legal_entity_namestringLegal name of the company seller. Valid only when tax_id_type = 2.
birthdayint64Birthday of the individual seller (stored as Unix timestamp). Valid only when tax_id_type = 1.
birthday_strstringBirthday of the individual seller (formatted as YYYY-MM-DD). Valid only when tax_id_type = 1.
state_registrationstringState registration number of the shop.
billing_addressobjectShop’s billing address details.
statestringState of the billing address.
citystringCity of the billing address.
addressstringSpecific detail of the billing address.
zipcodestringZIP code of the billing address.
neighborhoodstringNeighborhood of the billing address.
onboarding_statusint32Status of the shop’s current KYC onboarding process. Applicable values: 0: None 1: Regis Processing 2: Regis Validated 3: Regis Rejected 4: KYC Pending 5: KYC Processing 6: KYC Processing Manually 7: KYC Validated 8: KYC Rejected
submission_timeint32Timestamp when the onboarding information was submitted.
nationalitystringNationality of the individual seller. Valid only when tax_id_type=1.
cnae_mainstringMain CNAE code.
cnae_secondarystringSecondary CNAE code.
mei_checkstringMEI verification result. Applicable values: 0: No 1: Yes
onboarding_passedbooleanIndicate if the shop has passed KYC verification.