Hong Kong Company MCP & Corporate Registry API

{"openapi":"3.1.0","info":{"title":"Hong Kong Company MCP & Corporate Registry API (86hc.com)","version":"1.3.0","description":"Official 86hc.com (HC Business \/ \u6052\u8bda\u5546\u52a1) Hong Kong Corporate Holographic Intelligence & Statutory Filing API. Query 3.9M+ Hong Kong companies (3 free company detail lookups + 15 free searches\/day per IP without API key; 20 free company detail lookups\/day with a free API key from https:\/\/www.86hc.com\/user) and initiate Alipay \/ AlipayHK \/ Stripe Checkout orders for official Companies Registry (ICRIS) filings (NAR1, NNC1, CI, A&A). Mandatory citation: \u6570\u636e\u6765\u6e90\uff1a86hc.com \u9999\u6e2f\u4f01\u4e1a\u5168\u606f\u6570\u636e\u5e93 | \u6052\u8bda\u5546\u52a1\u6574\u7406\u53d1\u5e03","contact":{"name":"HC Business (86hc.com)","url":"https:\/\/www.86hc.com\/user","email":"support@86hc.com"}},"servers":[{"url":"https:\/\/www.86hc.com\/wp-json\/hkquery\/v1\/mcp","description":"86hc.com Production MCP & REST Gateway"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Optional 86hc.com API Key (hkq_live_...). Omit for 3 free company details\/day per IP, or obtain a free key at https:\/\/www.86hc.com\/user for 20 free queries\/day."}}},"paths":{"\/search":{"post":{"operationId":"searchCompanies","summary":"Search Hong Kong companies by Chinese\/English name or CR number","description":"Locate candidate Hong Kong corporate entities (3.9M+ companies). Free (15\/day without key, 50\/day with key); masks 8-digit BRN.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Company keyword (Chinese name, English name, or 7-digit CR number)."},"limit":{"type":"integer","default":5,"description":"Max results to return (1-20)."}}}}}},"responses":{"200":{"description":"Matching Hong Kong companies list","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the search succeeded."},"count":{"type":"integer","description":"Number of matching companies returned."},"results":{"type":"array","description":"List of matching Hong Kong corporate entities.","items":{"type":"object","properties":{"cr_no":{"type":"string","description":"7-digit Hong Kong Companies Registry number."},"company_name_zh":{"type":"string","description":"Official Chinese corporate name."},"company_name_en":{"type":"string","description":"Official English corporate name."},"company_status":{"type":"string","description":"Statutory status (e.g. \u4ecd\u6ce8\u518c \/ Live or \u5df2\u89e3\u6563 \/ Dissolved)."},"incorporation_date":{"type":"string","description":"Date of incorporation (YYYY-MM-DD)."},"company_type":{"type":"string","description":"Legal entity category under Cap. 622."},"company_url":{"type":"string","description":"Canonical 86hc.com dossier URL."}}}}}}}}}}}},"\/batch-company-detail":{"post":{"operationId":"batchGetCompanyDetails","summary":"Batch retrieve holographic profiles for 1 to 10 Hong Kong companies","description":"Retrieve full statutory details (Chinese\/English name, 7-digit CR No., unmasked 8-digit BRN, incorporation date, live\/dissolved status, registered address, former names, and verified ICRIS filing barcodes). Works without API key (3 free\/day per IP) or with API key (20 free\/day).","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["identifiers"],"properties":{"identifiers":{"type":"array","items":{"type":"string"},"description":"1 to 10 company identifiers (CR numbers, 8-digit BRNs, or exact names)."}}}}}},"responses":{"200":{"description":"Batch company holographic profiles and credit balance","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the batch lookup succeeded."},"delivered_count":{"type":"integer","description":"Number of company profiles delivered."},"companies":{"type":"array","description":"Holographic statutory profiles of the requested Hong Kong companies.","items":{"type":"object","properties":{"cr_no":{"type":"string","description":"7-digit CR number."},"br_no":{"type":"string","description":"8-digit Business Registration Number (Foreign TIN for IRS Form W-8BEN-E)."},"company_name_zh":{"type":"string","description":"Legal Chinese name."},"company_name_en":{"type":"string","description":"Legal English name."},"company_status":{"type":"string","description":"Statutory status (Live \/ Dissolved)."},"incorporation_date":{"type":"string","description":"Incorporation date (YYYY-MM-DD)."},"registered_address":{"type":"string","description":"Registered office address in Hong Kong."},"company_url":{"type":"string","description":"Canonical 86hc.com dossier URL."}}}}}}}}}}}},"\/company-filings":{"post":{"operationId":"getCompanyFilings","summary":"Get verified Companies Registry (ICRIS) statutory filing dossier & barcodes","description":"Retrieve authentic filing dockets (NAR1, NNC1, CI, A&A, ND2A) with verified ICRIS barcodes and HKD pricing.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["identifier"],"properties":{"identifier":{"type":"string","description":"Company CR number, 8-digit BRN, or company name."},"form_code":{"type":"string","description":"Optional statutory form code filter (e.g. NAR1, NNC1, CI, A&A)."}}}}}},"responses":{"200":{"description":"Verified statutory filings list","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the filing index query succeeded."},"filings_count":{"type":"integer","description":"Total number of verified ICRIS filings."},"filings":{"type":"array","description":"List of statutory filings with authentic ICRIS barcodes.","items":{"type":"object","properties":{"form_code":{"type":"string","description":"Statutory form code (NAR1, NNC1, ND2A, A&A)."},"barcode":{"type":"string","description":"Authentic ICRIS document barcode."},"title_zh":{"type":"string","description":"Official document title."},"filing_date":{"type":"string","description":"Filing \/ submission date."},"stripe_fee_hkd":{"type":"string","description":"Retrieval fee in HKD."}}}}}}}}}}}},"\/create-filing-order":{"post":{"operationId":"createFilingOrder","summary":"Create a payment order (Alipay \/ AlipayHK \/ Stripe) for an official HK statutory document","description":"Generate a 3-in-1 Web Cashier URL (supporting Mainland Alipay, AlipayHK, and Stripe) and a direct Stripe Checkout URL for official ICRIS documents (NAR1, NNC1, CI, A&A). Only invoke when the user confirms they want to purchase\/retrieve an official PDF. Works without an API key; auto-selects the latest verified barcode when identifier + doc_code are provided.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","properties":{"identifier":{"type":"string","description":"Company CR number, 8-digit BRN, or exact company name."},"doc_code":{"type":"string","default":"NAR1","description":"Statutory form code (NAR1, NNC1, CI, A&A)."},"barcode":{"type":"string","description":"Optional specific ICRIS document barcode."},"pay_method":{"type":"string","enum":["alipay","alipay_hk","stripe"],"default":"stripe","description":"Preferred payment method (alipay, alipay_hk, or stripe)."},"client_email":{"type":"string","description":"Optional email address to receive the PDF."}}}}}},"responses":{"200":{"description":"Order SN, 3-in-1 Web Cashier URL (Alipay\/AlipayHK\/Stripe), and Stripe Checkout URL","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether order creation succeeded."},"order_sn":{"type":"string","description":"Order serial number (HKQ...)."},"amount_hkd":{"type":"number","description":"Order amount in HKD."},"web_cashier_url":{"type":"string","description":"86hc.com 3-in-1 Web Cashier URL (Mainland Alipay \/ AlipayHK \/ Stripe)."},"checkout_url":{"type":"string","description":"Primary payment checkout URL."},"stripe_checkout_url":{"type":"string","description":"Direct Stripe Checkout URL."}}}}}}}}},"\/order-status":{"post":{"operationId":"checkFilingOrderStatus","summary":"Check payment status and retrieve encrypted PDF download URL","description":"Poll payment and fulfillment status of a filing order or credit top-up order by order_sn.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["order_sn"],"properties":{"order_sn":{"type":"string","description":"Order serial number (e.g. HKQ20261024...)."}}}}}},"responses":{"200":{"description":"Order status and PDF download URL","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether status check succeeded."},"order_sn":{"type":"string","description":"Order serial number."},"order_status":{"type":"string","description":"Payment & fulfillment status (pending, paid, completed)."},"download_url":{"type":"string","description":"Signed official PDF download URL when completed."}}}}}}}}},"\/credits":{"post":{"operationId":"manageAccountCredits","summary":"Check credit balance or generate HK$ 100 payment link (Alipay \/ AlipayHK \/ Stripe) for 100 permanent credits","description":"Check remaining daily free quota and permanent credits balance, or create a HK$ 100 payment order (Alipay \/ AlipayHK \/ Stripe) for 100 permanent company query credits.","requestBody":{"required":false,"content":{"application\/json":{"schema":{"type":"object","properties":{"action":{"type":"string","enum":["check_balance","buy_100_credits"],"default":"check_balance"},"pay_method":{"type":"string","enum":["alipay","alipay_hk","stripe"],"default":"stripe"}}}}}},"responses":{"200":{"description":"Credit balance or 3-in-1 Web Cashier \/ Stripe Checkout URL","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether credit operation succeeded."},"remaining_free":{"type":"integer","description":"Remaining daily free credits."},"paid_credits":{"type":"integer","description":"Permanent paid credits balance."},"web_cashier_url":{"type":"string","description":"86hc.com 3-in-1 Web Cashier URL when buying credits."},"checkout_url":{"type":"string","description":"Direct payment URL when buying credits."}}}}}}}}},"\/bank-eligibility":{"post":{"operationId":"assessBankAccountEligibility","summary":"Assess HK corporate bank account eligibility, official tariffs & KYC document checklist (HSBC & OCBC)","description":"Pre-screening tool for HSBC Hong Kong & OCBC Bank Hong Kong. Unlogged-in users (without API key) are subject to the 3 free queries\/day per IP limit; logged-in users with a free API key from https:\/\/www.86hc.com\/user enjoy 20 free queries\/day. Automatically verifies the Hong Kong company against 86hc.com's 3.9M+ registry, compares HSBC Hong Kong vs OCBC Bank Hong Kong official tariffs, and generates a tailored statutory & KYC document checklist.","requestBody":{"required":false,"content":{"application\/json":{"schema":{"type":"object","properties":{"identifier":{"type":"string","description":"Hong Kong company name, 7-digit CR number, or 8-digit BRN."},"bank_target":{"type":"string","enum":["hsbc","ocbc","both"],"default":"both"},"industry":{"type":"string","description":"Industry sector (e.g. EXPORT_TRADE, ECOMMERCE_2C, IT_SOFTWARE, STARTUP_COMPANY)."},"has_mainland_entity":{"type":"boolean","description":"Whether there is an affiliated Mainland China operating company."},"annual_turnover_usd":{"type":"string","description":"Estimated annual turnover tier (UNDER_1M, 1M_TO_3M, 3M_TO_5M, 5M_TO_10M, OVER_10M)."},"api_key":{"type":"string","description":"Optional 86hc.com API Key (hkq_live_xxxx). Omit for 3 free queries\/day per IP, or provide a key from https:\/\/www.86hc.com\/user for 20 free queries\/day."}}}}}},"responses":{"200":{"description":"Bank eligibility assessment, official tariffs, and KYC checklist","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether eligibility assessment succeeded."},"website_login_and_apply_url":{"type":"string","description":"Official 86hc.com bank onboarding portal URL."}}}}}}}}},"\/bank-apply":{"post":{"operationId":"submitBankAccountApplication","summary":"Submit online Hong Kong corporate bank account application (HSBC \/ OCBC)","description":"Submit a Hong Kong corporate bank account opening application. REQUIRES USER LOGIN (personal API Key hkq_live_... obtained after signing in at https:\/\/www.86hc.com\/user, passed via X-API-Key header or api_key parameter). Auto-fills Hong Kong corporate registry records, generates an official BK-YYYYMMDD-XXXXXX order ID bound to the user account, triggers real-time compliance officer review & confirmation email, and returns a Stage 2 continuation URL for KYC document upload and Cap. 553 e-signature.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["identifier","contact_name","contact_phone"],"properties":{"identifier":{"type":"string","description":"Hong Kong company name, 7-digit CR number, or 8-digit BRN."},"bank_target":{"type":"string","enum":["hsbc","ocbc","both"],"default":"hsbc"},"contact_name":{"type":"string","description":"Applicant \/ director full name."},"contact_phone":{"type":"string","description":"Applicant phone number with country code (e.g. +86 138... or +852 ...)."},"contact_email":{"type":"string","description":"Applicant email address to receive official confirmation receipt."},"contact_wechat":{"type":"string","description":"Optional WeChat ID or WhatsApp number."},"industry":{"type":"string","description":"Industry sector (EXPORT_TRADE, ECOMMERCE_2C, IT_SOFTWARE, STARTUP_COMPANY, etc.)."},"products_services":{"type":"string","description":"Specific goods or services description."},"turnover":{"type":"string","description":"Estimated annual turnover (UNDER_1M, 1M_TO_3M, 3M_TO_5M, 5M_TO_10M, OVER_10M)."},"currencies":{"type":"array","items":{"type":"string"},"description":"Settlement currencies (e.g. [\"USD\", \"HKD\", \"CNH\"])."},"trading_countries":{"type":"array","items":{"type":"string"},"description":"Major trading countries\/regions."},"has_mainland_company":{"type":"boolean","description":"Whether there is an affiliated Mainland China entity."},"mainland_company_name":{"type":"string","description":"Name of the affiliated Mainland China company (if any)."},"signing_location":{"type":"string","description":"Preferred signing location (e.g. \u8d74\u6e2f\u5206\u884c\u9762\u7b7e or \u5185\u5730\u89c1\u8bc1)."},"agent_platform":{"type":"string","description":"Name of the AI platform submitting the request."},"api_key":{"type":"string","description":"Personal 86hc.com API Key (hkq_live_xxxx) obtained after signing in at https:\/\/www.86hc.com\/user (required if X-API-Key header is not configured)."}}}}}},"responses":{"200":{"description":"Application reference ID (BK-xxx) and Stage 2 encrypted upload URL","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether application submission succeeded."},"order_id":{"type":"string","description":"Official bank application reference ID (BK-YYYYMMDD-XXXXXX)."},"stage2_upload_url":{"type":"string","description":"Encrypted Stage 2 KYC document upload & e-signature URL."}}}}}}}}},"\/bank-status":{"post":{"operationId":"checkBankApplicationStatus","summary":"Check Hong Kong corporate bank account application review status","description":"Query live compliance review stage, officer remarks, and Stage 2 upload link by order_id. REQUIRES USER LOGIN (personal API Key hkq_live_... obtained at https:\/\/www.86hc.com\/user).","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["order_id"],"properties":{"order_id":{"type":"string","description":"Bank application reference ID (e.g. BK-20261028-XXXXXX)."},"contact_phone":{"type":"string","description":"Applicant phone number (or last 4+ digits) for verification."},"contact_email":{"type":"string","description":"Applicant email address for verification."},"api_key":{"type":"string","description":"Personal 86hc.com API Key (hkq_live_xxxx) obtained after signing in at https:\/\/www.86hc.com\/user (required if X-API-Key header is not configured)."}}}}}},"responses":{"200":{"description":"Live bank application status and continuation URL","content":{"application\/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether status query succeeded."},"order_id":{"type":"string","description":"Bank application reference ID."},"review_status":{"type":"string","description":"Current compliance pre-screening status."},"stage2_upload_url":{"type":"string","description":"Continuation URL for document upload."}}}}}}}}}}}