openapi-directory/api/namsor.com.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.1","servers":[{"description":"namsor_v2","url":"https://v2.namsor.com/NamSorAPIv2","variables":{}}],"info":{"contact":{"email":"contact@namsor.com","name":"Namsor SAS","url":"http://www.namsor.com/","x-twitter":"gendreapp"},"description":"NamSor API v2 : enpoints to process personal names (gender, cultural origin or ethnicity) in all alphabets or languages. By default, enpoints use 1 unit per name (ex. Gender), but Ethnicity classification uses 10 to 20 units per name depending on taxonomy. Use GET methods for small tests, but prefer POST methods for higher throughput (batch processing of up to 100 names at a time). Need something you can't find here? We have many more features coming soon. Let us know, we'll do our best to add it! ","license":{"name":"NamSorAPI_Lic_v0.0.7","url":"https://v2.namsor.com/NamSorAPIv2/assets/pdf/201803_NamSor_API_Terms_v007.pdf"},"title":"NamSor API v2","version":"2.0.24","x-apisguru-categories":["text"],"x-logo":{"url":"https://twitter.com/gendreapp/profile_image?size=original"},"x-origin":[{"converter":{"url":"https://github.com/mermade/oas-kit","version":"7.0.4"},"format":"openapi","url":"https://v2.namsor.com/NamSorAPIv2/api2/openapi.json","version":"3.0"}],"x-providerName":"namsor.com"},"externalDocs":{"description":"NamSor API client SDKs v2 for Java, Python","url":"https://github.com/namsor"},"security":[{"api_key":[]}],"tags":[{"description":"Personal names (anthroponyms) : gender, country origin/ethnicity, diaspora, US 'race'/ethniciy","name":"personal"},{"description":"Social media and pseudonyms","name":"social"},{"description":"CHINESE special features","name":"chinese"},{"description":"JAPANESE special features","name":"japanese"},{"description":"INDIAN special features","name":"indian"},{"description":"Administrative, system management.","name":"admin"}],"paths":{"/api2/json/anonymize/{source}/{anonymized}/{token}":{"get":{"operationId":"anonymize","parameters":[{"in":"path","name":"source","required":true,"schema":{"type":"string"}},{"in":"path","name":"anonymized","required":true,"schema":{"type":"boolean"}},{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyOut"}}},"description":"Anonymization of a source."},"401":{"description":"Missing or incorrect API Key"}},"summary":"Activate/deactivate anonymization for a source.","tags":["admin"]}},"/api2/json/apiKeyInfo":{"get":{"operationId":"apiKeyInfo","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyOut"}}},"description":"Read API Key (uncached, i.e. DB read)"},"401":{"description":"Missing or incorrect API Key"}},"summary":"Read API Key info.","tags":["admin"]}},"/api2/json/apiServices":{"get":{"operationId":"availableServices","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIServicesOut"}}},"description":"Available services"},"401":{"description":"Missing or incorrect token"}},"summary":"List of classification services and usage cost in Units per classification (default is 1=ONE Unit). Some API endpoints (ex. Corridor) combine multiple classifiers.","tags":["admin"]}},"/api2/json/apiStatus":{"get":{"operationId":"apiStatus","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIClassifiersStatusOut"}}},"description":"Available classifiers and status"},"401":{"description":"Missing or incorrect token"}},"summary":"Prints the current status of the classifiers. A classifier name in apiStatus corresponds to a service name in apiServices.","tags":["admin"]}},"/api2/json/apiUsage":{"get":{"operationId":"apiUsage","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIPeriodUsageOut"}}},"description":"Print current API usage."},"401":{"description":"Missing or incorrect API Key"}},"security":[{"api_key":[]}],"summary":"Print current API usage.","tags":["admin"]}},"/api2/json/apiUsageHistory":{"get":{"operationId":"apiUsageHistory","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIUsageHistoryOut"}}},"description":"Print historical API usage (NB. new output format form v2.0.15)"},"401":{"description":"Missing or incorrect API Key"}},"security":[{"api_key":[]}],"summary":"Print historical API usage.","tags":["admin"]}},"/api2/json/apiUsageHistoryAggregate":{"get":{"operationId":"apiUsageHistoryAggregate","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIUsageAggregatedOut"}}},"description":"Print historical API usage."},"401":{"description":"Missing or incorrect API Key"}},"security":[{"api_key":[]}],"summary":"Print historical API usage (in an aggregated view, by service, by day/hour/min).","tags":["admin"]}},"/api2/json/castegroupIndianFull/{subDivisionIso31662}/{personalNameFull}":{"get":{"operationId":"castegroupIndianFull","parameters":[{"in":"path","name":"subDivisionIso31662","required":true,"schema":{"type":"string"}},{"in":"path","name":"personalNameFull","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameCastegroupOut"}}},"description":"A castegroup-coded name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 10 UNITS PER NAME] Infer the likely Indian name castegroup of a personal full name.","tags":["indian"]}},"/api2/json/castegroupIndianFullBatch":{"post":{"operationId":"castegroupIndianFullBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameSubdivisionIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameCastegroupOut"}}},"description":"A list of castegroup-coded names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 10 UNITS PER NAME] Infer the likely Indian name castegroup of up to 100 personal full names. ","tags":["indian"]}},"/api2/json/chineseNameCandidates/{chineseSurnameLatin}/{chineseGivenNameLatin}":{"get":{"operationId":"chineseNameCandidates","parameters":[{"in":"path","name":"chineseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"chineseGivenNameLatin","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchCandidatesOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify Chinese name candidates, based on the romanized name ex. Wang Xiaoming","tags":["chinese"]}},"/api2/json/chineseNameCandidatesBatch":{"post":{"operationId":"chineseNameCandidatesBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of personal Chinese names in LATIN, firstName = chineseGivenName; lastName=chineseSurname"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchCandidatesOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify Chinese name candidates, based on the romanized name (firstName = chineseGivenName; lastName=chineseSurname), ex. Wang Xiaoming","tags":["chinese"]}},"/api2/json/chineseNameCandidatesGenderBatch":{"post":{"operationId":"chineseNameCandidatesGenderBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGenderIn"}}},"description":"A list of personal Chinese names in LATIN, firstName = chineseGivenName; lastName=chineseSurname"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchCandidatesOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify Chinese name candidates, based on the romanized name (firstName = chineseGivenName; lastName=chineseSurname) ex. Wang Xiaoming.","tags":["chinese"]}},"/api2/json/chineseNameGenderCandidates/{chineseSurnameLatin}/{chineseGivenNameLatin}/{knownGender}":{"get":{"operationId":"chineseNameGenderCandidates","parameters":[{"in":"path","name":"chineseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"chineseGivenNameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"knownGender","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchCandidatesOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify Chinese name candidates, based on the romanized name ex. Wang Xiaoming - having a known gender ('male' or 'female')","tags":["chinese"]}},"/api2/json/chineseNameMatch/{chineseSurnameLatin}/{chineseGivenNameLatin}/{chineseName}":{"get":{"operationId":"chineseNameMatch","parameters":[{"in":"path","name":"chineseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"chineseGivenNameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"chineseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchedOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Return a score for matching Chinese name ex. 王晓明 with a romanized name ex. Wang Xiaoming","tags":["chinese"]}},"/api2/json/chineseNameMatchBatch":{"post":{"operationId":"chineseNameMatchBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMatchPersonalFirstLastNameIn"}}},"description":"A list of personal Chinese names in LATIN, firstName = chineseGivenName; lastName=chineseSurname"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify Chinese name candidates, based on the romanized name (firstName = chineseGivenName; lastName=chineseSurname), ex. Wang Xiaoming","tags":["chinese"]}},"/api2/json/corridor/{countryIso2From}/{firstNameFrom}/{lastNameFrom}/{countryIso2To}/{firstNameTo}/{lastNameTo}":{"get":{"operationId":"corridor","parameters":[{"in":"path","name":"countryIso2From","required":true,"schema":{"type":"string"}},{"in":"path","name":"firstNameFrom","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastNameFrom","required":true,"schema":{"type":"string"}},{"in":"path","name":"countryIso2To","required":true,"schema":{"type":"string"}},{"in":"path","name":"firstNameTo","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastNameTo","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorridorOut"}}},"description":"Two classified names."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 20 UNITS PER NAME COUPLE] Infer several classifications for a cross border interaction between names (ex. remit, travel, intl com)","tags":["personal"]}},"/api2/json/corridorBatch":{"post":{"operationId":"corridorBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchCorridorIn"}}},"description":"A list of name pairs, with country code (nameFrom -> nameTo)."},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchCorridorOut"}}},"description":"A list of classified name pairs."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 20 UNITS PER NAME PAIR] Infer several classifications for up to 100 cross border interaction between names (ex. remit, travel, intl com)","tags":["personal"]}},"/api2/json/country/{personalNameFull}":{"get":{"operationId":"country","parameters":[{"in":"path","name":"personalNameFull","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameGeoOut"}}},"description":"A origined name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 10 UNITS PER NAME] Infer the likely country of residence of a personal full name, or one surname. Assumes names as they are in the country of residence OR the country of origin.","tags":["personal"]}},"/api2/json/countryBatch":{"post":{"operationId":"countryBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGeoOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 10 UNITS PER NAME] Infer the likely country of residence of up to 100 personal full names, or surnames. Assumes names as they are in the country of residence OR the country of origin.","tags":["personal"]}},"/api2/json/diaspora/{countryIso2}/{firstName}/{lastName}":{"get":{"operationId":"diaspora","parameters":[{"in":"path","name":"countryIso2","required":true,"schema":{"type":"string"}},{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameDiasporaedOut"}}},"description":"A diaspora / ethnicity for given name and geography."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 20 UNITS PER NAME] Infer the likely ethnicity/diaspora of a personal name, given a country of residence ISO2 code (ex. US, CA, AU, NZ etc.)","tags":["personal"]}},"/api2/json/diasporaBatch":{"post":{"operationId":"diasporaBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGeoIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameDiasporaedOut"}}},"description":"A list of diaspora / ethnicity given a name and residency."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 20 UNITS PER NAME] Infer the likely ethnicity/diaspora of up to 100 personal names, given a country of residence ISO2 code (ex. US, CA, AU, NZ etc.)","tags":["personal"]}},"/api2/json/gender/{firstName}":{"get":{"operationId":"gender_1","parameters":[{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a just a fiven name, assuming default 'US' local context. Please use preferably full names and local geographic context for better accuracy.","tags":["personal"]}},"/api2/json/gender/{firstName}/{lastName}":{"get":{"operationId":"gender","parameters":[{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a name.","tags":["personal"]}},"/api2/json/genderBatch":{"post":{"operationId":"genderBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 names, detecting automatically the cultural context.","tags":["personal"]}},"/api2/json/genderChineseName/{chineseName}":{"get":{"operationId":"genderChineseName","parameters":[{"in":"path","name":"chineseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a Chinese full name ex. 王晓明","tags":["chinese"]}},"/api2/json/genderChineseNameBatch":{"post":{"operationId":"genderChineseNameBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names, with a country ISO2 code"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 full names ex. 王晓明","tags":["chinese"]}},"/api2/json/genderChineseNamePinyin/{chineseSurnameLatin}/{chineseGivenNameLatin}":{"get":{"operationId":"genderChineseNamePinyin","parameters":[{"in":"path","name":"chineseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"chineseGivenNameLatin","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a Chinese name in LATIN (Pinyin).","tags":["chinese"]}},"/api2/json/genderChineseNamePinyinBatch":{"post":{"operationId":"genderChineseNamePinyinBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of names, with country code."},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 Chinese names in LATIN (Pinyin).","tags":["chinese"]}},"/api2/json/genderFull/{fullName}":{"get":{"operationId":"genderFull","parameters":[{"in":"path","name":"fullName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a full name, ex. John H. Smith","tags":["personal"]}},"/api2/json/genderFullBatch":{"post":{"operationId":"genderFullBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 full names, detecting automatically the cultural context.","tags":["personal"]}},"/api2/json/genderFullGeo/{fullName}/{countryIso2}":{"get":{"operationId":"genderFullGeo","parameters":[{"in":"path","name":"fullName","required":true,"schema":{"type":"string"}},{"in":"path","name":"countryIso2","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a full name, given a local context (ISO2 country code).","tags":["personal"]}},"/api2/json/genderFullGeoBatch":{"post":{"operationId":"genderFullGeoBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGeoIn"}}},"description":"A list of personal names, with a country ISO2 code"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 full names, with a given cultural context (country ISO2 code).","tags":["personal"]}},"/api2/json/genderGeo/{firstName}/{lastName}/{countryIso2}":{"get":{"operationId":"genderGeo","parameters":[{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastName","required":true,"schema":{"type":"string"}},{"in":"path","name":"countryIso2","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a name, given a local context (ISO2 country code).","tags":["personal"]}},"/api2/json/genderGeoBatch":{"post":{"operationId":"genderGeoBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGeoIn"}}},"description":"A list of names, with country code."},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 names, each given a local context (ISO2 country code).","tags":["personal"]}},"/api2/json/genderJapaneseName/{japaneseSurname}/{japaneseGivenName}":{"get":{"operationId":"genderJapaneseNamePinyin","parameters":[{"in":"path","name":"japaneseSurname","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseGivenName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a Japanese name in LATIN (Pinyin).","tags":["japanese"]}},"/api2/json/genderJapaneseNameBatch":{"post":{"operationId":"genderJapaneseNamePinyinBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of names, with country code."},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 Japanese names in LATIN (Pinyin).","tags":["japanese"]}},"/api2/json/genderJapaneseNameFull/{japaneseName}":{"get":{"operationId":"genderJapaneseNameFull","parameters":[{"in":"path","name":"japaneseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameGenderedOut"}}},"description":"A genderized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of a Japanese full name ex. 王晓明","tags":["japanese"]}},"/api2/json/genderJapaneseNameFullBatch":{"post":{"operationId":"genderJapaneseNameFullBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGenderedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely gender of up to 100 full names","tags":["japanese"]}},"/api2/json/japaneseNameGenderKanjiCandidatesBatch":{"post":{"operationId":"japaneseNameGenderKanjiCandidatesBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameGenderIn"}}},"description":"A list of personal japanese names in LATIN, firstName = japaneseGivenName; lastName=japaneseSurname and known gender"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchCandidatesOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify japanese name candidates in KANJI, based on the romanized name (firstName = japaneseGivenName; lastName=japaneseSurname) with KNOWN gender, ex. Yamamoto Sanae","tags":["japanese"]}},"/api2/json/japaneseNameKanjiCandidates/{japaneseSurnameLatin}/{japaneseGivenNameLatin}":{"get":{"operationId":"japaneseNameKanjiCandidates_1","parameters":[{"in":"path","name":"japaneseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseGivenNameLatin","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchCandidatesOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify japanese name candidates in KANJI, based on the romanized name ex. Yamamoto Sanae","tags":["japanese"]}},"/api2/json/japaneseNameKanjiCandidates/{japaneseSurnameLatin}/{japaneseGivenNameLatin}/{knownGender}":{"get":{"operationId":"japaneseNameKanjiCandidates","parameters":[{"in":"path","name":"japaneseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseGivenNameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"knownGender","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchCandidatesOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify japanese name candidates in KANJI, based on the romanized name ex. Yamamoto Sanae - and a known gender.","tags":["japanese"]}},"/api2/json/japaneseNameKanjiCandidatesBatch":{"post":{"operationId":"japaneseNameKanjiCandidatesBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of personal japanese names in LATIN, firstName = japaneseGivenName; lastName=japaneseSurname"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchCandidatesOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Identify japanese name candidates in KANJI, based on the romanized name (firstName = japaneseGivenName; lastName=japaneseSurname), ex. Yamamoto Sanae","tags":["japanese"]}},"/api2/json/japaneseNameLatinCandidates/{japaneseSurnameKanji}/{japaneseGivenNameKanji}":{"get":{"operationId":"japaneseNameLatinCandidates","parameters":[{"in":"path","name":"japaneseSurnameKanji","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseGivenNameKanji","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchCandidatesOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Romanize japanese name, based on the name in Kanji.","tags":["japanese"]}},"/api2/json/japaneseNameLatinCandidatesBatch":{"post":{"operationId":"japaneseNameLatinCandidatesBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of personal japanese names in KANJI, firstName = japaneseGivenName; lastName=japaneseSurname"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchCandidatesOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Romanize japanese names, based on the name in KANJI","tags":["japanese"]}},"/api2/json/japaneseNameMatch/{japaneseSurnameLatin}/{japaneseGivenNameLatin}/{japaneseName}":{"get":{"operationId":"japaneseNameMatch","parameters":[{"in":"path","name":"japaneseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseGivenNameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameMatchedOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Return a score for matching Japanese name in KANJI ex. 山本 早苗 with a romanized name ex. Yamamoto Sanae","tags":["japanese"]}},"/api2/json/japaneseNameMatchBatch":{"post":{"operationId":"japaneseNameMatchBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchMatchPersonalFirstLastNameIn"}}},"description":"A list of personal Japanese names in LATIN, firstName = japaneseGivenName; lastName=japaneseSurname"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameMatchedOut"}}},"description":"A list of matched names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Return a score for matching a list of Japanese names in KANJI ex. 山本 早苗 with romanized names ex. Yamamoto Sanae","tags":["japanese"]}},"/api2/json/japaneseNameMatchFeedbackLoop/{japaneseSurnameLatin}/{japaneseGivenNameLatin}/{japaneseName}":{"get":{"operationId":"japaneseNameMatchFeedbackLoop","parameters":[{"in":"path","name":"japaneseSurnameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseGivenNameLatin","required":true,"schema":{"type":"string"}},{"in":"path","name":"japaneseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackLoopOut"}}},"description":"A romanized name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[CREDITS 1 UNIT] Feedback loop to better perform matching Japanese name in KANJI ex. 山本 早苗 with a romanized name ex. Yamamoto Sanae","tags":["japanese"]}},"/api2/json/learnable/{source}/{learnable}/{token}":{"get":{"operationId":"learnable","parameters":[{"description":"The API Key to set as learnable/non learnable.","in":"path","name":"source","required":true,"schema":{"type":"string"}},{"in":"path","name":"learnable","required":true,"schema":{"type":"boolean"}},{"in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyOut"}}},"description":"Set learning from source."},"401":{"description":"Missing or incorrect API Key"}},"summary":"Activate/deactivate learning from a source.","tags":["admin"]}},"/api2/json/nameType/{properNoun}":{"get":{"operationId":"nameType","parameters":[{"in":"path","name":"properNoun","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProperNounCategorizedOut"}}},"description":"A typed name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely type of a proper noun (personal name, brand name, place name etc.)","tags":["general"]}},"/api2/json/nameTypeBatch":{"post":{"operationId":"nameTypeBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameIn"}}},"description":"A list of proper names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchProperNounCategorizedOut"}}},"description":"A list of commonTypeized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely common type of up to 100 proper nouns (personal name, brand name, place name etc.)","tags":["general"]}},"/api2/json/nameTypeGeo/{properNoun}/{countryIso2}":{"get":{"operationId":"nameTypeGeo","parameters":[{"in":"path","name":"properNoun","required":true,"schema":{"type":"string"}},{"in":"path","name":"countryIso2","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProperNounCategorizedOut"}}},"description":"A typed name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely type of a proper noun (personal name, brand name, place name etc.)","tags":["general"]}},"/api2/json/nameTypeGeoBatch":{"post":{"operationId":"nameTypeGeoBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchNameGeoIn"}}},"description":"A list of proper names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchProperNounCategorizedOut"}}},"description":"A list of commonTypeized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely common type of up to 100 proper nouns (personal name, brand name, place name etc.)","tags":["general"]}},"/api2/json/origin/{firstName}/{lastName}":{"get":{"operationId":"origin","parameters":[{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNameOriginedOut"}}},"description":"A origined name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 10 UNITS PER NAME] Infer the likely country of origin of a personal name. Assumes names as they are in the country of origin. For US, CA, AU, NZ and other melting-pots : use 'diaspora' instead.","tags":["personal"]}},"/api2/json/originBatch":{"post":{"operationId":"originBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNameOriginedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 10 UNITS PER NAME] Infer the likely country of origin of up to 100 names, detecting automatically the cultural context.","tags":["personal"]}},"/api2/json/parseChineseName/{chineseName}":{"get":{"operationId":"parseChineseName","parameters":[{"in":"path","name":"chineseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameParsedOut"}}},"description":"A origined name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. 王晓明 -> 王(surname) 晓明(given name)","tags":["chinese"]}},"/api2/json/parseChineseNameBatch":{"post":{"operationId":"parseChineseNameBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameParsedOut"}}},"description":"A list of parsed names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. 王晓明 -> 王(surname) 晓明(given name).","tags":["chinese"]}},"/api2/json/parseJapaneseName/{japaneseName}":{"get":{"operationId":"parseJapaneseName","parameters":[{"in":"path","name":"japaneseName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameParsedOut"}}},"description":"A origined name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. 山本 早苗 or Yamamoto Sanae","tags":["japanese"]}},"/api2/json/parseJapaneseNameBatch":{"post":{"operationId":"parseJapaneseNameBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameParsedOut"}}},"description":"A list of parsed names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. 山本 早苗 or Yamamoto Sanae ","tags":["japanese"]}},"/api2/json/parseName/{nameFull}":{"get":{"operationId":"parseName","parameters":[{"in":"path","name":"nameFull","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameParsedOut"}}},"description":"A origined name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John. ","tags":["personal"]}},"/api2/json/parseName/{nameFull}/{countryIso2}":{"get":{"operationId":"parseNameGeo","parameters":[{"in":"path","name":"nameFull","required":true,"schema":{"type":"string"}},{"in":"path","name":"countryIso2","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalNameParsedOut"}}},"description":"A origined name."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John. For better accuracy, provide a geographic context.","tags":["personal"]}},"/api2/json/parseNameBatch":{"post":{"operationId":"parseNameBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameParsedOut"}}},"description":"A list of parsed names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John.","tags":["personal"]}},"/api2/json/parseNameGeoBatch":{"post":{"operationId":"parseNameGeoBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameGeoIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPersonalNameParsedOut"}}},"description":"A list of parsed names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"Infer the likely first/last name structure of a name, ex. John Smith or SMITH, John or SMITH; John. Giving a local context improves precision. ","tags":["personal"]}},"/api2/json/phoneCode/{firstName}/{lastName}/{phoneNumber}":{"get":{"operationId":"phoneCode","parameters":[{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastName","required":true,"schema":{"type":"string"}},{"in":"path","name":"phoneNumber","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNamePhoneCodedOut"}}},"description":"A name with country and phone code."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 11 UNITS PER NAME] Infer the likely country and phone prefix, given a personal name and formatted / unformatted phone number.","tags":["social"]}},"/api2/json/phoneCodeBatch":{"post":{"operationId":"phoneCodeBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNamePhoneNumberIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNamePhoneCodedOut"}}},"description":"A list of genderized names."},"400":{"description":"Bad request (ex. too many names)"},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 11 UNITS PER NAME] Infer the likely country and phone prefix, of up to 100 personal names, detecting automatically the local context given a name and formatted / unformatted phone number.","tags":["social"]}},"/api2/json/phoneCodeGeo/{firstName}/{lastName}/{phoneNumber}/{countryIso2}":{"get":{"operationId":"phoneCodeGeo","parameters":[{"in":"path","name":"firstName","required":true,"schema":{"type":"string"}},{"in":"path","name":"lastName","required":true,"schema":{"type":"string"}},{"in":"path","name":"phoneNumber","required":true,"schema":{"type":"string"}},{"in":"path","name":"countryIso2","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstLastNamePhoneCodedOut"}}},"description":"A name with country and phone code."},"401":{"description":"Missing or incorrect API Key"},"403":{"description":"Email not Verified, or API Limit Reached, or API Key Disabled"}},"security":[{"api_key":[]}],"summary":"[USES 11 UNITS PER NAME] Infer the likely phone prefix, given a personal name and formatted / unformatted phone number, with a local context (ISO2 country of residence).","tags":["social"]}},"/api2/json/phoneCodeGeoBatch":{"post":{"operationId":"phoneCodeGeoBatch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFirstLastNamePhoneNumberGeoIn"}}},"description":"A list of personal names"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref