{"swagger":"2.0","info":{"title":"Flowwise Dutch Company Data","description":"Look up Dutch company data by KVK number or find companies by name, and use the company name, KVK number and registered visiting address in a flow.","version":"0.1","contact":{"name":"Sulejman Hot","url":"https://flowwise.dev","email":"shot@hey.com"}},"host":"flowwise-kvk.shot-projects.workers.dev","basePath":"/v1","schemes":["https"],"consumes":[],"produces":["application/json"],"paths":{"/companies":{"get":{"summary":"Find companies by name","description":"Searches the Dutch KVK register by company or trade name and returns the best match plus a list of matching companies with their KVK numbers.","operationId":"SearchCompaniesByName","x-ms-visibility":"important","parameters":[{"name":"name","in":"query","required":true,"type":"string","minLength":2,"maxLength":100,"x-ms-summary":"Company name","description":"The company or trade name to search for. Partial names are allowed."},{"name":"limit","in":"query","required":false,"type":"integer","format":"int32","default":10,"minimum":1,"maximum":20,"x-ms-summary":"Maximum results","x-ms-visibility":"advanced","description":"The maximum number of companies to return (1-20)."}],"responses":{"200":{"description":"The matching companies. The list is empty when nothing matches.","schema":{"$ref":"#/definitions/CompanySearchResponse"}},"400":{"description":"The company name or limit is invalid.","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"The API key is missing or invalid.","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"The customer request limit has been reached.","schema":{"$ref":"#/definitions/ErrorResponse"}},"503":{"description":"The data provider is temporarily unavailable.","schema":{"$ref":"#/definitions/ErrorResponse"}}}}},"/companies/{kvkNumber}":{"get":{"summary":"Get company details","description":"Returns the company name and registered visiting address for a Dutch KVK number.","operationId":"GetCompanyByKvkNumber","x-ms-visibility":"important","parameters":[{"name":"kvkNumber","in":"path","required":true,"type":"string","pattern":"^[0-9]{8}$","x-ms-summary":"KVK number","description":"The eight-digit Dutch KVK number."}],"responses":{"200":{"description":"The matching company details.","schema":{"$ref":"#/definitions/Company"}},"400":{"description":"The KVK number is invalid.","schema":{"$ref":"#/definitions/ErrorResponse"}},"401":{"description":"The API key is missing or invalid.","schema":{"$ref":"#/definitions/ErrorResponse"}},"429":{"description":"The customer request limit has been reached.","schema":{"$ref":"#/definitions/ErrorResponse"}},"503":{"description":"The data provider is temporarily unavailable.","schema":{"$ref":"#/definitions/ErrorResponse"}}}}}},"definitions":{"Company":{"type":"object","required":["kvkNumber","companyName","tradeName","address"],"properties":{"kvkNumber":{"type":"string","description":"The Dutch KVK number.","title":"KVK number"},"companyName":{"type":"string","description":"The registered company name.","title":"Company name"},"tradeName":{"type":"string","description":"The trade name.","title":"Trade name"},"address":{"$ref":"#/definitions/Address"}}},"CompanySearchResponse":{"type":"object","required":["query","totalResults","results"],"properties":{"query":{"type":"string","description":"The normalized search text.","title":"Search text"},"totalResults":{"type":"integer","format":"int32","description":"The number of companies returned.","title":"Number of results"},"bestMatch":{"type":"object","x-nullable":true,"title":"Best match","description":"The highest-ranked company, or null when nothing matches.","properties":{"kvkNumber":{"type":"string","description":"The Dutch KVK number.","title":"Best match KVK number"},"companyName":{"type":"string","description":"The registered company name.","title":"Best match company name"},"tradeName":{"type":"string","description":"The trade name.","title":"Best match trade name"},"address":{"type":"object","x-nullable":true,"title":"Address","description":"The registered visiting address, or null when the registration has no usable address.","properties":{"street":{"type":"string","description":"Street name.","title":"Street"},"houseNumber":{"type":"string","description":"House number.","title":"House number"},"houseNumberAddition":{"type":"string","x-nullable":true,"description":"Optional house number addition.","title":"House number addition"},"postalCode":{"type":"string","description":"Dutch postal code without spaces.","title":"Postal code"},"city":{"type":"string","description":"City or town.","title":"City"},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","title":"Country code"}}}}},"results":{"type":"array","title":"Results","description":"All matching companies in KVK ranking order.","items":{"$ref":"#/definitions/CompanySearchResult"}}}},"CompanySearchResult":{"type":"object","required":["kvkNumber","companyName","tradeName"],"properties":{"kvkNumber":{"type":"string","description":"The Dutch KVK number.","title":"KVK number"},"companyName":{"type":"string","description":"The registered company name.","title":"Company name"},"tradeName":{"type":"string","description":"The trade name.","title":"Trade name"},"address":{"type":"object","x-nullable":true,"title":"Address","description":"The registered visiting address, or null when the registration has no usable address.","properties":{"street":{"type":"string","description":"Street name.","title":"Street"},"houseNumber":{"type":"string","description":"House number.","title":"House number"},"houseNumberAddition":{"type":"string","x-nullable":true,"description":"Optional house number addition.","title":"House number addition"},"postalCode":{"type":"string","description":"Dutch postal code without spaces.","title":"Postal code"},"city":{"type":"string","description":"City or town.","title":"City"},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","title":"Country code"}}}}},"Address":{"type":"object","required":["street","houseNumber","postalCode","city","countryCode"],"properties":{"street":{"type":"string","description":"Street name.","title":"Street"},"houseNumber":{"type":"string","description":"House number.","title":"House number"},"houseNumberAddition":{"type":"string","x-nullable":true,"description":"Optional house number addition.","title":"House number addition"},"postalCode":{"type":"string","description":"Dutch postal code without spaces.","title":"Postal code"},"city":{"type":"string","description":"City or town.","title":"City"},"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","title":"Country code"}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string","description":"Machine-readable error code."},"message":{"type":"string","description":"Human-readable error message."},"requestId":{"type":"string","description":"Reference ID for support."}}}}}},"securityDefinitions":{"ApiKey":{"type":"apiKey","description":"The API key provided by Flowwise.","name":"X-API-Key","in":"header"}},"security":[{"ApiKey":[]}],"tags":[],"x-ms-connector-metadata":[{"propertyName":"Website","propertyValue":"https://flowwise.dev"},{"propertyName":"Privacy policy","propertyValue":"https://flowwise.dev/privacy-policy/"},{"propertyName":"Categories","propertyValue":"Business Management"}]}