{"openapi":"3.1.0","info":{"title":"GlobalCheck Customer API","description":"GlobalCheck 客户 API，提供企业检索、身份解析、企业详情、股权关系、财务数据和批量导出能力。受保护接口使用 X-API-Key。","version":"1.0.0","contact":{"name":"GlobalCheck API Support","email":"support@globalcheck.cn"}},"paths":{"/api/v1/companies/{company_id}/overview":{"get":{"tags":["companies"],"summary":"获取企业概览","description":"获取企业的基本信息概览，支持不同的详细程度","operationId":"get_company_overview_api_v1_companies__company_id__overview_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"},{"name":"detail_level","in":"query","required":false,"schema":{"enum":["basic","detailed"],"type":"string","description":"详细程度：basic=基础信息（483字段），detailed=详细信息（493字段）","default":"basic","title":"Detail Level"},"description":"详细程度：basic=基础信息（483字段），detailed=详细信息（493字段）"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/search":{"get":{"tags":["companies"],"summary":"搜索公司","description":"根据多种条件搜索公司","operationId":"search_companies_api_v1_companies_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"搜索关键词（公司名称）","title":"Q"},"description":"搜索关键词（公司名称）"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"国家代码（ISO）","title":"Country"},"description":"国家代码（ISO）"},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"城市（前缀匹配，IDR 二次过滤）","title":"City"},"description":"城市（前缀匹配，IDR 二次过滤）"},{"name":"postcode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"邮编（前缀匹配，IDR 二次过滤）","title":"Postcode"},"description":"邮编（前缀匹配，IDR 二次过滤）"},{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"行业代码（NACE）","title":"Industry"},"description":"行业代码（NACE）"},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"公司状态","title":"Status"},"description":"公司状态"},{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"跳过记录数","default":0,"title":"Skip"},"description":"跳过记录数"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回记录数","default":20,"title":"Limit"},"description":"返回记录数"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/contacts":{"get":{"tags":["companies"],"summary":"获取联系信息","description":"获取企业的联系方式和地址信息","operationId":"get_company_contacts_api_v1_companies__company_id__contacts_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/industry":{"get":{"tags":["companies"],"summary":"获取行业信息","description":"获取企业的行业分类和主营业务信息","operationId":"get_company_industry_api_v1_companies__company_id__industry_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/risk-assessment":{"get":{"tags":["companies"],"summary":"Get company country and industry risk assessment","description":"Resolve the company country and industry codes against the active risk reference release.","operationId":"get_company_risk_assessment_api_v1_companies__company_id__risk_assessment_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"Company ID","title":"Company Id"},"description":"Company ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/auditors-advisors":{"get":{"tags":["companies"],"summary":"获取审计师和顾问信息","description":"获取企业的审计师、银行家及其他顾问信息","operationId":"get_company_auditors_advisors_api_v1_companies__company_id__auditors_advisors_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/directors":{"get":{"tags":["companies"],"summary":"获取董事和管理人员信息","description":"获取企业的董事会成员和高级管理人员信息","operationId":"get_company_directors_api_v1_companies__company_id__directors_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/identification":{"get":{"tags":["companies"],"summary":"获取识别号码信息","description":"获取企业的各类识别号码（税号、注册号等）","operationId":"get_company_identification_api_v1_companies__company_id__identification_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/legal-info":{"get":{"tags":["companies"],"summary":"获取法律和注册信息","description":"获取企业的法律形式、注册日期、公司状态等信息","operationId":"get_company_legal_info_api_v1_companies__company_id__legal_info_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/segments":{"get":{"tags":["companies"],"summary":"获取业务细分数据","description":"获取企业的业务细分和地域细分数据","operationId":"get_company_segments_api_v1_companies__company_id__segments_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/trade-payment":{"get":{"tags":["companies"],"summary":"获取贸易支付与履约表现信息","description":"获取企业的支付风险评分、信用评级、履约表现等信息","operationId":"get_company_trade_payment_api_v1_companies__company_id__trade_payment_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/filter-options":{"get":{"tags":["companies"],"summary":"获取搜索筛选选项","description":"获取搜索页面所需的筛选项下拉数据（国家、城市、状态、行业等），带24小时缓存","operationId":"get_filter_options_api_v1_companies_filter_options_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/{company_id}/exists":{"get":{"tags":["companies"],"summary":"检查公司是否存在","description":"快速检查指定company_id是否存在（排除无效企业）","operationId":"check_company_exists_api_v1_companies__company_id__exists_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/companies/statistics/countries":{"get":{"tags":["companies"],"summary":"获取各国企业数量统计","description":"获取所有国家的企业数量统计，用于地图展示","operationId":"get_country_statistics_api_v1_companies_statistics_countries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/companies/statistics/summary":{"get":{"tags":["companies"],"summary":"获取汇总统计数据","description":"获取覆盖国家数和收录企业总数，供首页展示，数据在启动预热时计算并缓存","operationId":"get_summary_statistics_api_v1_companies_statistics_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/api/v1/ownership/{company_id}/shareholders":{"get":{"tags":["ownership"],"summary":"获取股东列表","description":"获取企业的股东信息","operationId":"get_shareholders_api_v1_ownership__company_id__shareholders_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/ownership/{company_id}/branches":{"get":{"tags":["ownership"],"summary":"获取分支机构列表","description":"获取企业的分支机构和总部信息","operationId":"get_branches_api_v1_ownership__company_id__branches_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/ownership/{company_id}/subsidiaries":{"get":{"tags":["ownership"],"summary":"获取子公司列表","description":"获取企业的子公司和关联公司信息","operationId":"get_subsidiaries_api_v1_ownership__company_id__subsidiaries_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/ownership/{company_id}/private-equity":{"get":{"tags":["ownership"],"summary":"获取私募股权信息","description":"获取企业的私募股权所有权信息","operationId":"get_private_equity_api_v1_ownership__company_id__private_equity_get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/financials/{company_id}":{"get":{"tags":["financials"],"summary":"获取财务数据","description":"获取企业的财务指标和经营数据","operationId":"get_financial_data_api_v1_financials__company_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","description":"公司ID","title":"Company Id"},"description":"公司ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/export/create":{"post":{"tags":["export"],"summary":"创建导出任务","description":"创建批量导出任务，支持同步和异步处理","operationId":"create_export_task_api_v1_export_create_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/export/{task_id}/status":{"get":{"tags":["export"],"summary":"查询任务状态","description":"查询导出任务的处理状态和进度","operationId":"get_task_status_api_v1_export__task_id__status_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"任务ID","title":"Task Id"},"description":"任务ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/export/{task_id}/download":{"get":{"tags":["export"],"summary":"下载导出文件","description":"下载已完成的导出文件","operationId":"download_export_file_api_v1_export__task_id__download_get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"任务ID","title":"Task Id"},"description":"任务ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/export/{task_id}":{"delete":{"tags":["export"],"summary":"取消任务","description":"取消等待处理的导出任务","operationId":"cancel_export_task_api_v1_export__task_id__delete","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","description":"任务ID","title":"Task Id"},"description":"任务ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/export/my-tasks":{"get":{"tags":["export"],"summary":"列出我的导出任务","description":"查看当前用户的导出任务列表","operationId":"list_my_export_tasks_api_v1_export_my_tasks_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["pending","processing","completed","failed"],"type":"string"},{"type":"null"}],"description":"过滤状态","title":"Status"},"description":"过滤状态"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"返回数量","default":20,"title":"Limit"},"description":"返回数量"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/export/statistics":{"get":{"tags":["export"],"summary":"导出统计","description":"获取导出任务的统计信息","operationId":"get_export_statistics_api_v1_export_statistics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/api/v1/idr/resolve":{"post":{"tags":["idr"],"summary":"单条企业身份解析","description":"根据企业名称、国家、注册号、LEI 等输入，返回 GlobalCheck ApexID 候选和匹配证据。MVP 版本只读数据库，不持久化结果。","operationId":"resolve_company_identity_api_v1_idr_resolve_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IDRResolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IDRResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/health":{"get":{"summary":"健康检查","description":"健康检查端点","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health Check Health Get"}}}}},"security":[]}}},"components":{"schemas":{"CompanyListResponse":{"properties":{"items":{"items":{},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"skip":{"type":"integer","title":"Skip"},"limit":{"type":"integer","title":"Limit"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","skip","limit","has_more"],"title":"CompanyListResponse","description":"公司列表响应"},"ExportRequest":{"properties":{"type":{"type":"string","enum":["search_results","company_full","companies_batch","module_export"],"title":"Type","description":"导出类型"},"module":{"type":"string","title":"Module","description":"模块名称"},"filters":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Filters","description":"过滤条件"},"format":{"type":"string","enum":["xlsx","csv","json"],"title":"Format","description":"导出格式","default":"xlsx"},"fields_layer":{"type":"string","enum":["A","B","C"],"title":"Fields Layer","description":"字段层级","default":"B"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename","description":"自定义文件名"}},"type":"object","required":["type","module"],"title":"ExportRequest","description":"导出请求","example":{"fields_layer":"B","filters":{"country":"HK","status":"Active"},"format":"xlsx","module":"company_overview","type":"search_results"}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IDRCandidateResponse":{"properties":{"rank":{"type":"integer","title":"Rank"},"apex_id":{"type":"string","title":"Apex Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name"},"legal_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"postcode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postcode"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"reg_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reg Number"},"trade_register_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trade Register Number"},"registration_numbers":{"items":{"type":"string"},"type":"array","title":"Registration Numbers"},"legacy_registration_numbers":{"items":{"type":"string"},"type":"array","title":"Legacy Registration Numbers"},"lei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lei"},"swift_bic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Swift Bic"},"tax_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tax Id"},"tax_ids":{"items":{"type":"string"},"type":"array","title":"Tax Ids"},"identifiers":{"type":"object","title":"Identifiers"},"isin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Isin"},"latest_sales":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Latest Sales"},"score":{"type":"number","title":"Score"},"mgs":{"type":"string","title":"Mgs"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"basic_info":{"type":"object","title":"Basic Info"},"evidence":{"type":"object","title":"Evidence"}},"type":"object","required":["rank","apex_id","score","mgs"],"title":"IDRCandidateResponse"},"IDRResolveRequest":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"公司名称"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"国家/地区 ISO2 代码"},"apex_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apex Id","description":"Apex ID"},"reg_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reg Number","description":"注册号"},"lei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lei","description":"LEI"},"swift_bic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Swift Bic","description":"SWIFT/BIC"},"tax_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tax Id","description":"税号"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website","description":"官网或邮箱域名"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"城市"},"postcode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postcode","description":"邮编"},"_custom":{"type":"object","title":" Custom","description":"客户自定义字段，原样保留"}},"type":"object","title":"IDRResolveRequest","description":"单条 IDR 解析请求。"},"IDRResolveResponse":{"properties":{"record_id":{"type":"string","title":"Record Id"},"status":{"type":"string","title":"Status"},"confidence":{"type":"number","title":"Confidence"},"confidence_band":{"type":"string","title":"Confidence Band"},"recommended_action":{"type":"string","title":"Recommended Action"},"apex_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apex Id"},"matched_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Name"},"matched_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Name En"},"matched_legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Legal Name"},"matched_legal_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Legal Name En"},"matched_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Country"},"matched_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Status"},"matched_basic_info":{"type":"object","title":"Matched Basic Info"},"mgs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mgs"},"evidence":{"type":"object","title":"Evidence"},"candidates":{"items":{"$ref":"#/components/schemas/IDRCandidateResponse"},"type":"array","title":"Candidates"},"decision_meta":{"type":"object","title":"Decision Meta"},"processing_time_ms":{"type":"integer","title":"Processing Time Ms"}},"type":"object","required":["record_id","status","confidence","confidence_band","recommended_action","processing_time_ms"],"title":"IDRResolveResponse"},"TaskResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"is_async":{"type":"boolean","title":"Is Async"},"total_records":{"type":"integer","title":"Total Records"},"estimated_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Time"},"check_url":{"type":"string","title":"Check Url"},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download Url"}},"type":"object","required":["task_id","status","is_async","total_records","check_url"],"title":"TaskResponse","description":"任务响应"},"TaskStatusResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","title":"Status"},"progress":{"type":"integer","title":"Progress"},"total_records":{"type":"integer","title":"Total Records"},"processed_records":{"type":"integer","title":"Processed Records"},"created_at":{"type":"string","title":"Created At"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"estimated_completion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estimated Completion"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["task_id","status","progress","total_records","processed_records","created_at"],"title":"TaskStatusResponse","description":"任务状态响应"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"GlobalCheck 分配的客户 API Key"}}},"servers":[{"url":"https://api.globalcheck.cn"}],"externalDocs":{"description":"GlobalCheck API 接入指南","url":"https://globalcheck.cn/developers/api"}}