--- updatedAt: 2026-04-23T12:39:24.000Z agentTools: projectIndex: https://foxentry.dev/llms.txt --- # Search email Foxentry will automatically offer you suggestions to complete the e-mail address you are writing down. This mainly serves as autocomplete.

Pay attention to the client section in the request body. You can specify the user's location in order to receive more relevant suggestions. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "version": "2.1", "title": "Foxentry API reference", "termsOfService": "https://foxentry.com/terms-and-conditions", "description": "# Welcome to the Foxentry API version 2.1\nWelcome to the new version of Foxentry API 2.1 Our API is designed to enhance your data management experience and provide you with even more powerful tools to harness the potential of getting and working with data.\n## API usage\nThe Foxentry API is used to retrieve, validate, and modify user data. Using our API, you can obtain detailed information, validate customer input, and automatically edit it into the appropriate formats.

\nThe new version of our API also supports automatic corrections, offering you suggestions and corrections for your inputs so that you always get the right data.\n## Features in version 2.1\nFoxentry now provides you with a wide variety of information by providing a comprehensive set of endpoints for numerous data categories. Whether you need information on a Company, an Email address, a Location, a Name, or a Phone number, Foxentry can help. We are pleased to offer our valued clients a total of 12 endpoints in this new version.

\nWith the latest version of the Foxentry API, we have implemented advanced Corrections and Suggestions. This means that the data you receive will be more refined and precise, enabling you to make data-driven decisions with the utmost confidence.

\nThe latest Foxentry API version includes HTTP global errors but also local error messages, recognizing the need for clear and useful error feedback. If a problem happens while using the API, you will be notified in descriptive error messages, providing a smoother integration process and quicker issue resolution.

\nTo further enhance data quality, Foxentry has introduced Fixes in the new version of the API. This means that even if there are minor errors in the data you provide, the API will intelligently identify and correct them, reducing the risk of inaccuracies in your results.\n## API call\nEach API call should be directed to a specific endpoint URL. Each API call to an endpoint can only contain one API request.\n## Environment\nProduction: https://api.foxentry.com/\n## Supported countries\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
EndpointSupported countries
company/validateCzech Republic, Hungary, Poland, and Slovakia
company/searchCzech Republic, Hungary, Poland, and Slovakia
company/getCzech Republic, Hungary, Poland, and Slovakia
email/validateWorldwide
email/searchWorldwide
location/validateAlbania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City
location/searchAlbania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City
location/getAlbania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City
location/localizeAlbania, Andorra, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, France, Germany, Greece, Hungary, Iceland, Italy, Kosovo, Liechtenstein, Luxembourg, Malta, Monaco, Montenegro, Netherlands, North Macedonia, Poland, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Switzerland, United Kingdom, and Vatican City
name/validateCzech Republic and Slovakia
phone/validateWorldwide
\n\n## Security\nAs part of our commitment to data security, you are required to obtain a Bearer token from Foxentry. If you are a new user and do not have an API key, create your account at https://app.foxentry.com/registration and generate the key in your project settings. \n\n## Need help? \nShould you encounter any issues, have questions, or need assistance, please feel free to reach out to our dedicated support team at info@foxentry.com. We are here to help you make the most of our API and resolve any questions you may have.", "contact": { "name": "Foxentry", "email": "info@foxentry.com", "url": "https://www.foxentry.com" } }, "servers": [ { "url": "https://api.foxentry.com" } ], "paths": { "/company/get": { "post": { "tags": [ "Company" ], "summary": "Get company data", "description": "Foxentry allows you to get information about company based on the dataScope option. Country and registrationNumber parameters are required.", "operationId": "CompanyGet", "parameters": [ { "name": "api-version", "in": "header", "description": "API version.", "required": false, "schema": { "type": "string", "default": "2.1", "example": "2.1" } }, { "name": "foxentry-include-request-details", "in": "header", "description": "Parameter to add details of your request.", "required": false, "schema": { "type": "boolean", "default": false, "example": false } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "request": { "type": "object", "allOf": [ { "type": "object", "properties": { "customId": { "type": [ "string", "null" ], "description": "Custom ID assigned by you if you need so.", "example": "customer567914" }, "query": { "type": "object", "properties": { "country": { "type": "string", "description": "Country code in format [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).", "example": "CZ" }, "registrationNumber": { "type": "string", "description": "Company registration number.", "example": "04997476" } }, "required": [ "country", "registrationNumber" ] }, "options": { "type": "object", "description": "Query options.", "properties": { "dataScope": { "type": "string", "enum": [ "basic", "extended", "full" ], "description": "Data scope of returned data.", "default": "basic", "example": "full" }, "dataSource": { "description": "Array of allowed data sources, which restricts countries the module searches. Although we use the `request.client` object to provide most relevant results, it is generally recommended to to limit this option to only the necessary sources - especially if you don't utilize the `request.client` object.", "type": "array", "items": { "type": "string", "example": "CZ" }, "default": [ "CZ", "HU", "PL", "SK" ], "example": [ "CZ", "SK", "PL", "HU" ] }, "includeTerminatedSubjects": { "type": "boolean", "description": "Whether or not to include entities that have already ended their existence in the output.", "default": false, "example": false }, "zipFormat": { "description": "Whether to return locally formatted ZIP code or not. (130 00 vs 13000).", "type": "boolean", "default": false, "example": false }, "cityFormat": { "description": "This option determines the format in which the city is returned. Minimal = Praha, basic = Praha 8, extended = Praha 8 - Karlín.", "type": "string", "enum": [ "minimal", "basic", "extended" ], "default": "basic", "example": "basic" }, "nameFormat": { "description": "This option determines the format in which the name is returned. official returns the official name of the company as in official registers, normalized returns normalized name of the company (in standardized format). Example: official = Lidl Magyarország Kereskedelmi Betéti Társaság, normalized = Lidl Magyarország Bt.", "type": "string", "enum": [ "official", "normalized" ], "default": "normalized", "example": "normalized" }, "countryFormat": { "description": "This option determines the format in which the country is returned. Supported formats: alpha2 = CZ, alpha3 = CZE, local = Česká republika, international = Czech Republic, localShortened = Česko, internationalShortened = Czechia.", "type": "string", "enum": [ "alpha2", "alpha3", "local", "localShortened", "international", "internationalShortened" ], "default": "alpha2", "example": "alpha2" } } }, "client": { "type": "object", "description": "Additional information about your user (from whom you've obtained the data sent in query) to increase relevance of the results. If you do not wish to provide this information, you can limit results to relevant countries using the `dataSource` parameter present in some modules.", "properties": { "ip": { "type": "string", "description": "IP address of your end user (IPv4 or IPv6). Used for geolocation to make results — for example for the search endpoints — more relevant to the user's location. If you have the user's GPS coordinates, prefer sending those via `location`, as an IP address may be less precise.", "examples": [ "127.0.1.1", "2001:db8::8a2e:370:7334" ] }, "country": { "type": "string", "description": "Country code in [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.", "example": "CZ" }, "location": { "type": "object", "description": "Latitude & longitude of the client's approximate location.", "properties": { "lat": { "type": "number", "description": "Client's latitude", "example": 50.0628 }, "lon": { "type": "number", "description": "Client's longitude", "example": 13.9271 } } } } } } } ], "required": [ "query" ] } }, "required": [ "request" ] }, "examples": { "Request Example": { "value": { "request": { "query": { "country": "CZ", "registrationNumber": "04997476" }, "options": { "dataScope": "full", "includeTerminatedSubjects": false, "cityFormat": "basic", "zipFormat": false }, "client": { "country": "CZ", "location": { "lat": 50.0628, "lon": 13.9271 } } } } } } } } }, "responses": { "200": { "description": "Successful response", "headers": { "foxentry-api-version": { "schema": { "type": "string", "example": "2.1" }, "description": "The version of the Foxentry API" }, "foxentry-daily-credits-left": { "schema": { "type": "number", "example": 9881.64 }, "description": "The amount of daily credits left" }, "foxentry-daily-credits-limit": { "schema": { "type": "number", "example": 1000 }, "description": "The daily credits limit" }, "foxentry-rate-limit": { "schema": { "type": "integer", "example": 5000 }, "description": "The rate limit" }, "foxentry-rate-limit-period": { "schema": { "type": "integer", "example": 900 }, "description": "The rate limit period" }, "foxentry-rate-limit-remaining": { "schema": { "type": "integer", "example": 4999 }, "description": "The remaining rate limit" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 200 }, "request": { "allOf": [ { "type": "object", "properties": { "endpoint": { "example": "company/get" } } }, { "type": "object", "properties": { "endpoint": { "type": "string", "description": "Endpoint name." }, "code": { "type": "string", "description": "Code of request.", "example": "gc0nCfcELaPSHH4Qo4UBaC7DbAj6G4" }, "customId": { "type": [ "string", "null" ], "description": "Custom ID assigned by you if you need so.", "example": "customer567914" } }, "required": [ "endpoint", "code" ] }, { "$ref": "#/paths/~1company~1get/post/requestBody/content/application~1json/schema/properties/request/allOf/0" } ] }, "response": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "flags": { "type": "object", "properties": { "isActive": { "type": [ "boolean", "null" ], "description": "Indicates whether the company is currently active.", "example": true }, "isVatPayer": { "type": [ "boolean", "null" ], "description": "Indicates whether the company is a VAT payer. Available in extended and full datascopes.", "example": true }, "isVatSubject": { "type": [ "boolean", "null" ], "description": "Indicates whether the company is a VAT subject. Available in extended and full datascopes.", "example": true }, "isInInsolvency": { "type": [ "boolean", "null" ], "description": "Indicates whether the company is currently in insolvency. Available in full datascope in select countries.", "example": false } } }, "data": { "type": "object", "properties": { "country": { "type": [ "string", "null" ], "description": "Country code in format [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).", "example": "CZ" }, "uuid": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ], "description": "Name of company (in format requested by option nameFormat).", "example": "Avantro s.r.o." }, "nameOfficial": { "type": [ "string", "null" ], "description": "Name of company (as in official register).", "example": "Avantro s.r.o." }, "nameAlternative": { "type": [ "string", "null" ], "description": "Alternative name of company.", "example": "AVANTRO s. r. o." }, "nameNormalized": { "type": [ "string", "null" ], "description": "Normalized name of company.", "example": "Avantro s.r.o." }, "registrationNumber": { "type": [ "string", "null" ], "description": "Company registration number.", "example": "04997476" }, "taxNumber": { "type": [ "string", "null" ], "description": "Company tax number.", "example": "CZ04997476" }, "vatNumber": { "type": [ "string", "null" ], "description": "Company vat number.", "example": "CZ04997476" }, "vatNumberSpecial": { "type": [ "string", "null" ], "description": "Special vat number in case that subject is part of VAT group.", "example": "CZ0581019" }, "address": { "oneOf": [ { "$ref": "#/paths/~1location~1get/post/responses/200/content/application~1json/schema/properties/response/properties/results/items" }, { "type": "null", "title": "No data" } ] }, "addressOfficial": { "type": [ "object", "null" ], "description": "Address data from the official registry. Not validated by Foxentry.", "properties": { "data": { "type": [ "object", "null" ], "properties": { "country": { "type": [ "string", "null" ], "description": "Country of administrative area in format [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).", "example": "CZ" }, "street": { "type": [ "string", "null" ], "description": "Street.", "example": "Jeseniova" }, "number": { "$ref": "#/paths/~1location~1get/post/responses/200/content/application~1json/schema/properties/response/properties/results/items/properties/data/properties/number" }, "streetWithNumber": { "type": [ "string", "null" ], "description": "Street with number.", "example": "Jeseniova 1151/55" }, "city": { "type": [ "string", "null" ], "description": "City.", "example": "Praha" }, "zip": { "type": [ "string", "null" ], "description": "ZIP code.", "example": "13000" }, "full": { "type": [ "string", "null" ], "description": "Full address.", "example": "Jeseniova 1151/55 Praha 130000" } } } } }, "nace": { "type": "array", "description": "Types of business", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "Code of business.", "example": "74" }, "name": { "type": "string", "description": "Name of business", "example": "Ostatní profesní, vědecké a technické činnosti" }, "isPrimary": { "type": [ "boolean", "null" ], "description": "Determines if it is the main object of the business.", "example": false } } } }, "databoxes": { "type": "array", "description": "Company's electronic mail boxes (databoxes).", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "Code of databox.", "example": "txutpba" }, "name": { "type": "string", "description": "Name of databox.", "example": "AVANTRO s.r.o." }, "receivingMessages": { "type": "boolean", "description": "Whether the databox is set to receive messages from public as well.", "example": true } } } }, "registrations": { "type": "array", "description": "Information about the company's registrations.", "items": { "type": "object", "properties": { "type": { "enum": [ "businessRegister", "vatRegister" ], "description": "Type of registration.", "example": "businessRegister" }, "data": { "type": "object", "properties": { "register": { "type": "object", "description": "Information about register.", "properties": { "code": { "type": [ "string", "null" ], "description": "Code of register.", "example": null }, "name": { "type": [ "string", "null" ], "description": "Name of register.", "example": "CENTRALNA EWIDENCJA I INFORMACJA O DZIAŁALNOŚCI GOSPODARCZEJ" }, "detail": { "type": [ "string", "null" ], "description": "Detail of register.", "example": null } } }, "registrator": { "type": "object", "description": "Information about registrator.", "properties": { "code": { "type": [ "string", "null" ], "description": "Code of register.", "example": "MSPH" }, "name": { "type": [ "string", "null" ], "description": "Name of registrator.", "example": "Městský soud v Praze" }, "detail": { "type": [ "string", "null" ], "description": "Detail of registration.", "example": "Územní pracoviště pro Prahu 8, Trojská 13a, PRAHA 8, tel. 266 013 111" } } }, "reference": { "type": [ "string", "null" ], "description": "Registration reference.", "example": "C 256795" } } } } } }, "legalForm": { "type": "object", "properties": { "type": { "description": "Legal form type", "enum": [ "juridical", "physical", null ], "default": "juridical", "example": "juridical" }, "code": { "type": [ "string", "null" ], "description": "Code of legal form.", "example": "112" }, "name": { "type": [ "string", "null" ], "description": "Name of legal form.", "example": "Společnost s ručením omezeným." } } }, "legalFormSpecific": { "type": "object", "description": "Specific cases of legalForm.", "properties": { "code": { "type": [ "string", "null" ], "description": "Code of legal form for Polish companies.", "example": null }, "name": { "type": [ "string", "null" ], "description": "Name of legal form for Polish companies.", "example": null } } }, "esa2010": { "type": "object", "description": "The European System of National and Regional Accounts.", "properties": { "code": { "type": [ "string", "null" ], "description": "Code of ESA2010.", "example": "11002" }, "name": { "type": [ "string", "null" ], "description": "Name of ESA2010.", "example": "Nefinanční podniky soukromé národní" } } }, "dates": { "type": "object", "description": "Important dates associated with company.", "properties": { "created": { "type": [ "string", "null" ], "description": "Company creation date.", "format": "date", "example": "2016-04-15" }, "terminated": { "type": [ "string", "null" ], "description": "Company termination date.", "format": "date", "example": "2016-04-15" } } }, "employees": { "type": "object", "description": "Employees information.", "properties": { "count": { "type": [ "number", "null" ], "description": "Number of employees.", "example": null }, "category": { "type": [ "string", "null" ], "description": "Category of employees.", "example": "1000-1499" } } }, "insolvency": { "type": [ "object", "null" ], "description": "Company insolvency status with history", "properties": { "history": { "type": "array", "items": { "type": "object", "properties": { "reference": { "type": "string", "description": "Official reference of insolvency.", "example": "65 INS 12632 / 2023" }, "dateFrom": { "type": "string", "description": "Since when is the insolvence valid.", "format": "date", "example": "2021-08-01" }, "dateTo": { "type": "string", "description": "Until when is the insolvency valid.", "format": "date", "example": "2025-08-01" }, "court": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of court", "example": "Krajský soud v Hradci Králové." } } }, "status": { "type": "string", "description": "Status of insolvency.", "example": "NEVYRIZENA" }, "detailUrl": { "type": "string", "description": "Detail URL of insolvency.", "format": "url", "example": "https://isir.justice.cz/isir/ueu/evidence_upadcu_detail.do?id=F" } } } } } }, "businessPremises": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": [ "string", "null" ], "description": "Label of business premises", "example": "Obchodní centrum Havlíčkův Brod." }, "address": { "type": "object", "properties": { "full": { "type": "string", "description": "Full address.", "example": "Nad Rybníkem 3169, 580 01, Havlíčkův Brod" } } }, "activitySubjects": { "type": "string", "description": "Types of activity associated with the premise.", "example": "Zprostředkovatelská činnost" } } } }, "authority": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of authority.", "example": "Statutární orgán" }, "members": { "type": "array", "description": "Members associated with company.", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "name of member.", "example": "Pavel Hrdlička" }, "address": { "oneOf": [ { "$ref": "#/paths/~1location~1get/post/responses/200/content/application~1json/schema/properties/response/properties/results/items" }, { "type": "null", "title": "No data" } ] }, "addressOfficial": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/response/properties/results/items/properties/data/properties/addressOfficial" }, "function": { "type": [ "string", "null" ], "description": "Member function.", "example": "jednatel" }, "birthDate": { "type": [ "string", "null" ], "format": "date", "description": "Member date of birth.", "example": "1988-08-01" }, "registrationNumber": { "type": [ "number", "null" ], "description": "Member registration number.", "example": null } } } }, "decisions": { "type": "array", "description": "Information about the company's manner of decision making.", "items": { "type": [ "string", "null" ], "description": "Member decisions.", "example": "Společnost zastupuje jednatel samostatně." } } } } }, "capital": { "type": "object", "description": "Company's funding", "properties": { "value": { "type": "object", "properties": { "amount": { "type": [ "string", "null" ], "description": "Amount of capital.", "example": "200000" }, "currency": { "type": [ "string", "null" ], "description": "Currency of capital.", "example": "CZK" } } }, "shareholders": { "type": "array", "description": "Information about shareholders.", "items": { "type": "object", "properties": { "shareholder": { "type": "string", "description": "Information about shareholder.", "example": "PAVEL HRDLIČKA , dat. nar. 14. listopadu 1990 V Zahradách 277, 751 11 Radslavice" }, "share": { "type": "object", "properties": { "amount": { "type": "string", "description": "Amount of share.", "example": "200000" }, "currency": { "type": "string", "description": "Currency of share.", "example": "CZK" }, "percent": { "type": "string", "description": "Share percentage.", "example": "100" }, "percentPaid": { "type": "string", "description": "Share percentage paid.", "example": "100" } } }, "info": { "type": "array", "description": "Textual information about the share.", "items": { "type": "string", "description": "Information about share", "example": "Druh podílu: základní, se kterým nejsou spojené žádné zvláštní práva a povinnosti" } } } } }, "stocks": { "type": "array", "description": "Textual description of the stock amount and value.", "items": { "type": "string", "description": "List of stocks.", "example": "100 ks akcie na jméno v listinné podobě ve jmenovité hodnotě 20 000 ,- Kč." } } } }, "tradeLicences": { "type": "array", "description": "Trade licence information.", "items": { "type": "object", "properties": { "type": { "type": "string", "description": "Type of trade licence.", "example": "Ohlašovací volná" }, "name": { "type": "string", "description": "Name of trade licenses.", "example": "Výroba, obchod a služby neuvedené v přílohách 1 až 3 živnostenského zákona" }, "valid": { "type": "object", "properties": { "from": { "type": "string", "description": "Valid from.", "example": "2016-04-15" }, "fromText": { "type": [ "string", "null" ], "description": "Description of validation (from).", "example": "Dnem zápisu do spolkového rejstříku." }, "to": { "type": [ "string", "null" ], "description": "Valid to.", "example": "2030-04-15" }, "toText": { "type": [ "string", "null" ], "description": "Description of validation (to).", "example": "Na dobu neurčitou." } } }, "interrupted": { "type": "object", "description": "Dates of interuption.", "properties": { "from": { "type": [ "string", "null" ], "description": "Validity of the authorisation (from).", "format": "date", "example": "2021-08-15" }, "to": { "type": [ "string", "null" ], "description": "Validity of the authorisation (to).", "format": "date", "example": "2025-08-15" } } }, "responsiblePerson": { "type": [ "string", "null" ], "description": "Responsible person.", "example": "Jan Novák" }, "activitySubjects": { "type": "array", "items": { "type": "string", "description": "Subject of activity.", "example": "Broušení technického a šperkového kamene" } } } } }, "vat": { "type": "object", "description": "Vat payer information.", "properties": { "status": { "type": [ "string", "null" ], "description": "Vat current status. Payer, non payer and subject. Subject means the company is a VAT payer only for non domestic transactions (identifikovaná osoba).", "example": "payer", "enum": [ "payer", "nonpayer", "subject" ] }, "reliability": { "type": "object", "description": "Reliability of the VAT payer.", "properties": { "reliable": { "type": [ "boolean", "null" ], "description": "Determines whether or not the subject is reliable.", "example": true }, "unreliableFrom": { "type": [ "string", "null" ], "format": "date", "description": "Determines from when the subject is unreliable.", "example": "2018-09-01" } } }, "bankAccounts": { "type": "array", "description": "Bank accounts associated with the VAT payer.", "items": { "type": "object", "properties": { "number": { "type": "string", "example": "55567899/2010" } } } }, "history": { "type": "array", "description": "History of the VAT payer.", "items": { "type": "object", "properties": { "vatNumber": { "type": "string", "description": "Company vat number.", "example": "CZ04997476" }, "registrationType": { "type": "string", "description": "Company registration type.", "example": "payer" }, "validFrom": { "type": "string", "description": "Valid from.", "example": "2017-09-01" }, "validTo": { "type": [ "string", "null" ], "description": "Valid to.", "example": null }, "isGroupRegistration": { "type": "boolean", "description": "Is part of group registration.", "example": false } } } } } } } } }, "required": [ "data" ] } } }, "required": [ "results" ] }, "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": {}, "maxItems": 0 } }, "required": [ "status", "request", "response" ] }, "examples": { "basicDataScope": { "value": { "status": 200, "request": { "endpoint": "company/get", "code": "29ec5c92-a03e-4e3d-97d9-8c4de4591394", "query": { "registrationNumber": "04997476", "country": "CZ" }, "options": { "dataSource": [ "CZ", "SK", "PL" ], "dataScope": "basic", "includeTerminatedSubjects": false, "nameFormat": "normalized", "countryFormat": "alpha2", "cityFormat": "basic", "zipFormat": false } }, "response": { "results": [ { "data": { "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb8c52e1", "country": "CZ", "name": "AVANTRO s.r.o.", "nameOfficial": "AVANTRO s.r.o.", "nameAlternative": null, "nameNormalized": "AVANTRO s.r.o.", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null, "address": { "data": { "country": "CZ", "state": null, "region": "Hlavní město Praha", "district": "území Hlavního města Prahy", "ids": { "internal": "d2ade877-1e95-4a83-baa6-5431ce5b3ca8", "external": "22349995" }, "street": "Thámova", "number": { "type": "č.p.", "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "full": "Thámova 137/16, 18600 Praha 8" } }, "addressOfficial": { "data": { "country": "CZ", "street": "Thámova", "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, 18600 Praha" } }, "legalForm": { "type": "juridical" } }, "flags": { "isActive": true } } ] }, "errors": [] } }, "extendedDataScope": { "value": { "status": 200, "request": { "endpoint": "company/get", "code": "20fe2bb6-b256-4482-ba0d-354102fca964", "query": { "registrationNumber": "04997476", "country": "CZ" }, "options": { "dataSource": [ "CZ", "SK", "PL" ], "dataScope": "extended", "includeTerminatedSubjects": false, "nameFormat": "normalized", "countryFormat": "alpha2", "cityFormat": "basic", "zipFormat": false } }, "response": { "results": [ { "data": { "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb8c52e1", "country": "CZ", "name": "AVANTRO s.r.o.", "nameOfficial": "AVANTRO s.r.o.", "nameAlternative": null, "nameNormalized": "AVANTRO s.r.o.", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null, "address": { "data": { "country": "CZ", "state": null, "region": "Hlavní město Praha", "district": "území Hlavního města Prahy", "ids": { "internal": "d2ade877-1e95-4a83-baa6-5431ce5b3ca8", "external": "22349995" }, "street": "Thámova", "number": { "type": "č.p.", "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "full": "Thámova 137/16, 18600 Praha 8" } }, "addressOfficial": { "data": { "country": "CZ", "street": "Thámova", "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, 18600 Praha" } }, "legalForm": { "type": "juridical", "code": "112", "name": "Společnost s ručením omezeným" }, "legalFormSpecific": { "code": null, "name": null }, "nace": [ { "code": "00", "name": "Výroba, obchod a služby neuvedené v přílohách 1 až 3 živnostenského zákona", "isPrimary": null }, { "code": "74", "name": "Ostatní odborné, vědecké a technické činnosti", "isPrimary": null }, { "code": "68200", "name": "Pronájem a správa vlastních nebo pronajatých nemovitostí", "isPrimary": null } ], "registrations": [ { "type": "businessRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": "MSPH", "name": "Městský soud v Praze", "detail": null }, "reference": "C 256795" } }, { "type": "vatRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": "008", "name": "Územní pracoviště pro Prahu 8", "detail": null }, "reference": null } } ], "esa2010": { "code": "11002", "name": "Národní soukromé nefinanční podniky" }, "dates": { "created": "2016-04-15", "terminated": null }, "tradeLicences": [ { "type": "živnost volná", "name": "Výroba, obchod a služby neuvedené v přílohách 1 až 3 živnostenského zákona", "valid": { "from": "2016-04-15", "fromText": null, "to": null, "toText": null }, "interrupted": { "from": null, "to": null }, "responsiblePerson": null, "activitySubjects": [ "Povrchové úpravy a svařování kovů a dalších materiálů", "Výroba neelektrických zařízení pro domácnost", "Výroba a opravy čalounických výrobků", "Sklenářské práce, rámování a paspartování", "Výroba jízdních kol, vozíků pro invalidy a jiných nemotorových dopravních prostředků", "Provozování vodovodů a kanalizací a úprava a rozvod vody", "Stavba a výroba plavidel", "Výroba motorových a přípojných vozidel a karoserií", "Výroba zdravotnických prostředků", "Výroba elektronických součástek, elektrických zařízení a výroba a opravy elektrických strojů, přístrojů a elektronických zařízení pracujících na malém napětí", "Výroba a opravy zdrojů ionizujícího záření", "Umělecko-řemeslné zpracování kovů", "Broušení technického a šperkového kamene", "Výroba brusiv a ostatních minerálních nekovových výrobků", "Výroba stavebních hmot, porcelánových, keramických a sádrových výrobků", "Výroba koksu, surového dehtu a jiných pevných paliv", "Výroba, rozmnožování, distribuce, prodej, pronájem zvukových a zvukově-obrazových záznamů a výroba nenahraných nosičů údajů a záznamů", "Výroba potravinářských a škrobárenských výrobků", "Pěstitelské pálení", "Úprava nerostů, dobývání rašeliny a bahna", "Zastavárenská činnost a maloobchod s použitým zbožím", "Výroba a zpracování skla", "Údržba motorových vozidel a jejich příslušenství", "Poskytování služeb pro rodinu a domácnost", "Výroba, vývoj, projektování, zkoušky, instalace, údržba, opravy, modifikace a konstrukční změny letadel, motorů letadel, vrtulí, letadlových částí a zařízení a leteckých pozemních zařízení", "Zpracování dřeva, výroba dřevěných, korkových, proutěných a slaměných výrobků", "Služby v oblasti administrativní správy a služby organizačně hospodářské povahy", "Reklamní činnost, marketing, mediální zastoupení", "Výroba a opravy obuvi, brašnářského a sedlářského zboží", "Diagnostická, zkušební a poradenská činnost v ochraně rostlin a ošetřování rostlin, rostlinných produktů, objektů a půdy proti škodlivým organismům přípravky na ochranu rostlin nebo biocidními přípravky", "Skladování, balení zboží, manipulace s nákladem a technické činnosti v dopravě", "Velkoobchod a maloobchod", "Zprostředkování obchodu a služeb", "Přípravné a dokončovací stavební práce, specializované stavební činnosti", "Výroba drážních hnacích vozidel a drážních vozidel na dráze tramvajové, trolejbusové a lanové a železničního parku", "Nakládání s odpady (vyjma nebezpečných)", "Výroba dalších výrobků zpracovatelského průmyslu", "Výroba školních a kancelářských potřeb, kromě výrobků z papíru, výroba bižuterie, kartáčnického a konfekčního zboží, deštníků, upomínkových předmětů", "Výroba strojů a zařízení", "Provozování cestovní agentury a průvodcovská činnost v oblasti cestovního ruchu", "Návrhářská, designérská, aranžérská činnost a modeling", "Projektování pozemkových úprav", "Poradenská a konzultační činnost, zpracování odborných studií a posudků", "Činnost informačních a zpravodajských kanceláří", "Poskytování technických služeb", "Praní pro domácnost, žehlení, opravy a údržba oděvů, bytového textilu a osobního zboží", "Provozování tělovýchovných a sportovních zařízení a organizování sportovní činnosti", "Provozování kulturních, kulturně-vzdělávacích a zábavních zařízení, pořádání kulturních produkcí, zábav, výstav, veletrhů, přehlídek, prodejních a obdobných akcí", "Mimoškolní výchova a vzdělávání, pořádání kurzů, školení, včetně lektorské činnosti", "Nakládání s reprodukčním materiálem lesních dřevin", "Testování, měření, analýzy a kontroly", "Výzkum a vývoj v oblasti přírodních a technických věd nebo společenských věd", "Projektování elektrických zařízení", "Příprava a vypracování technických návrhů, grafické a kresličské práce", "Pronájem a půjčování věcí movitých", "Poskytování software, poradenství v oblasti informačních technologií, zpracování dat, hostingové a související činnosti a webové portály", "Ubytovací služby", "Zasilatelství a zastupování v celním řízení", "Potrubní a pozemní doprava (vyjma železniční a silniční motorové dopravy)", "Fotografické služby", "Chov zvířat a jejich výcvik (s výjimkou živočišné výroby)", "Činnost odborného lesního hospodáře a vyhotovování lesních hospodářských plánů a osnov", "Výroba, opravy a údržba sportovních potřeb, her, hraček a dětských kočárků", "Výroba měřicích, zkušebních, navigačních, optických a fotografických přístrojů a zařízení", "Výroba kovových konstrukcí a kovodělných výrobků", "Výroba a hutní zpracování železa, drahých a neželezných kovů a jejich slitin", "Výroba plastových a pryžových výrobků", "Výroba hnojiv", "Výroba chemických látek a chemických směsí nebo předmětů a kosmetických přípravků", "Vydavatelské činnosti, polygrafická výroba, knihařské a kopírovací práce", "Výroba vlákniny, papíru a lepenky a zboží z těchto materiálů", "Výroba textilií, textilních výrobků, oděvů a oděvních doplňků", "Výroba krmiv, krmných směsí, doplňkových látek a premixů", "Poskytování služeb pro zemědělství, zahradnictví, rybníkářství, lesnictví a myslivost", "Výroba, obchod a služby jinde nezařazené", "Poskytování služeb osobního charakteru a pro osobní hygienu", "Opravy a údržba potřeb pro domácnost, předmětů kulturní povahy, výrobků jemné mechaniky, optických přístrojů a měřidel", "Překladatelská a tlumočnická činnost", "Nákup, prodej, správa a údržba nemovitostí" ] } ], "vat": { "status": "payer", "reliability": { "reliable": true, "unreliableFrom": null }, "bankAccounts": [ { "number": "55567899/2010" }, { "number": "CZ8920100000002301370338" }, { "number": "CZ1420100000002801976854" }, { "number": "CZ6620100000002902049945" } ], "history": [] } }, "flags": { "isActive": true, "isVatPayer": true, "isVatSubject": false } } ] }, "errors": [] } }, "fullDataScope": { "value": { "status": 200, "request": { "endpoint": "company/get", "code": "aabe7368-020d-4d39-bd73-186da0ddfcd0", "query": { "registrationNumber": "04997476", "country": "CZ" }, "options": { "dataSource": [ "CZ", "SK", "PL" ], "dataScope": "full", "includeTerminatedSubjects": false, "nameFormat": "normalized", "countryFormat": "alpha2", "cityFormat": "basic", "zipFormat": false } }, "response": { "results": [ { "data": { "uuid": "ca3665de-ded1-47f7-9bcd-b8c3eb8c52e1", "country": "CZ", "name": "AVANTRO s.r.o.", "nameOfficial": "AVANTRO s.r.o.", "nameAlternative": null, "nameNormalized": "AVANTRO s.r.o.", "registrationNumber": "04997476", "taxNumber": null, "vatNumber": "CZ04997476", "vatNumberSpecial": null, "address": { "data": { "country": "CZ", "state": null, "region": "Hlavní město Praha", "district": "území Hlavního města Prahy", "cityDistrictSpecial": "Praha 8", "cityDistrict": "Praha 8", "cityPart": "Karlín", "cityAdministrative": null, "cadastralArea": "Karlín", "ids": { "internal": "d2ade877-1e95-4a83-baa6-5431ce5b3ca8", "external": "22349995", "region": "19", "district": "9999", "cityDistrictSpecial": "86", "cityDistrict": "500208", "cityPart": "400637", "cadastralArea": "730955", "city": "554782", "street": "472093" }, "street": "Thámova", "number": { "type": "č.p.", "part1": "137", "part1Number": "137", "part1Letter": null, "part2": "16", "part2Number": "16", "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha 8", "zip": "18600", "geometry": { "gps": { "lat": 50.0920005, "lon": 14.4527363 }, "custom": [ { "type": "JTSK", "coordinates": { "x": 1042819.66, "y": 740509.43 } } ] }, "postOffice": { "name": "Praha 86" }, "full": "Thámova 137/16, 18600 Praha 8" } }, "addressOfficial": { "data": { "country": "CZ", "street": "Thámova", "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "137/16" }, "streetWithNumber": "Thámova 137/16", "city": "Praha", "zip": "18600", "full": "Thámova 137/16, 18600 Praha" } }, "legalForm": { "type": "juridical", "code": "112", "name": "Společnost s ručením omezeným" }, "legalFormSpecific": { "code": null, "name": null }, "nace": [ { "code": "00", "name": "Výroba, obchod a služby neuvedené v přílohách 1 až 3 živnostenského zákona", "isPrimary": null }, { "code": "74", "name": "Ostatní odborné, vědecké a technické činnosti", "isPrimary": null }, { "code": "68200", "name": "Pronájem a správa vlastních nebo pronajatých nemovitostí", "isPrimary": null } ], "databoxes": [ { "code": "txutpba", "name": "AVANTRO s.r.o.", "receivingMessages": true } ], "registrations": [ { "type": "businessRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": "MSPH", "name": "Městský soud v Praze", "detail": null }, "reference": "C 256795" } }, { "type": "vatRegister", "data": { "register": { "code": null, "name": null, "detail": null }, "registrator": { "code": "008", "name": "Územní pracoviště pro Prahu 8", "detail": null }, "reference": null } } ], "esa2010": { "code": "11002", "name": "Národní soukromé nefinanční podniky" }, "dates": { "created": "2016-04-15", "terminated": null }, "employees": { "category": "1-5", "count": null }, "insolvency": null, "businessPremises": [], "authority": [ { "name": "Statutární orgán", "members": [ { "name": "PAVEL HRDLIČKA", "address": { "data": { "country": "CZ", "state": null, "region": "Olomoucký kraj", "district": "Přerov", "cityDistrictSpecial": null, "cityDistrict": null, "cityPart": "Radslavice", "cityAdministrative": null, "cadastralArea": "Radslavice u Přerova", "ids": { "internal": "4beb117d-e8e1-48ef-a14f-81d906c79ba6", "external": "11148616", "region": "124", "district": "3808", "cityDistrictSpecial": null, "cityDistrict": null, "cityPart": "138819", "cadastralArea": "738816", "city": "517534", "street": "524549" }, "street": "V Zahradách", "number": { "type": "č.p.", "part1": "277", "part1Number": "277", "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "277" }, "streetWithNumber": "V Zahradách 277", "city": "Radslavice", "zip": "75111", "geometry": { "gps": { "lat": 49.4781175, "lon": 17.5104831 }, "custom": [ { "type": "JTSK", "coordinates": { "x": 1136105.4, "y": 529721.06 } } ] }, "postOffice": { "name": "Radslavice" }, "full": "V Zahradách 277, 75111 Radslavice" } }, "addressOfficial": { "data": { "country": "CZ", "street": "V Zahradách", "number": { "part1": null, "part1Number": null, "part1Letter": null, "part2": null, "part2Number": null, "part2Letter": null, "full": "277" }, "streetWithNumber": "V Zahradách 277", "city": "Radslavice", "zip": "75111", "full": null } }, "function": "jednatel", "birthDate": "1990-11-14", "registrationNumber": null } ], "decisions": [ "Společnost zastupuje jednatel samostatně." ] } ], "capital": { "value": { "amount": null, "currency": null }, "shareholders": [], "stocks": [] }, "tradeLicences": [ { "type": "živnost volná", "name": "Výroba, obchod a služby neuvedené v přílohách 1 až 3 živnostenského zákona", "valid": { "from": "2016-04-15", "fromText": null, "to": null, "toText": null }, "interrupted": { "from": null, "to": null }, "responsiblePerson": null, "activitySubjects": [ "Povrchové úpravy a svařování kovů a dalších materiálů", "Výroba neelektrických zařízení pro domácnost", "Výroba a opravy čalounických výrobků", "Sklenářské práce, rámování a paspartování", "Výroba jízdních kol, vozíků pro invalidy a jiných nemotorových dopravních prostředků", "Provozování vodovodů a kanalizací a úprava a rozvod vody", "Stavba a výroba plavidel", "Výroba motorových a přípojných vozidel a karoserií", "Výroba zdravotnických prostředků", "Výroba elektronických součástek, elektrických zařízení a výroba a opravy elektrických strojů, přístrojů a elektronických zařízení pracujících na malém napětí", "Výroba a opravy zdrojů ionizujícího záření", "Umělecko-řemeslné zpracování kovů", "Broušení technického a šperkového kamene", "Výroba brusiv a ostatních minerálních nekovových výrobků", "Výroba stavebních hmot, porcelánových, keramických a sádrových výrobků", "Výroba koksu, surového dehtu a jiných pevných paliv", "Výroba, rozmnožování, distribuce, prodej, pronájem zvukových a zvukově-obrazových záznamů a výroba nenahraných nosičů údajů a záznamů", "Výroba potravinářských a škrobárenských výrobků", "Pěstitelské pálení", "Úprava nerostů, dobývání rašeliny a bahna", "Zastavárenská činnost a maloobchod s použitým zbožím", "Výroba a zpracování skla", "Údržba motorových vozidel a jejich příslušenství", "Poskytování služeb pro rodinu a domácnost", "Výroba, vývoj, projektování, zkoušky, instalace, údržba, opravy, modifikace a konstrukční změny letadel, motorů letadel, vrtulí, letadlových částí a zařízení a leteckých pozemních zařízení", "Zpracování dřeva, výroba dřevěných, korkových, proutěných a slaměných výrobků", "Služby v oblasti administrativní správy a služby organizačně hospodářské povahy", "Reklamní činnost, marketing, mediální zastoupení", "Výroba a opravy obuvi, brašnářského a sedlářského zboží", "Diagnostická, zkušební a poradenská činnost v ochraně rostlin a ošetřování rostlin, rostlinných produktů, objektů a půdy proti škodlivým organismům přípravky na ochranu rostlin nebo biocidními přípravky", "Skladování, balení zboží, manipulace s nákladem a technické činnosti v dopravě", "Velkoobchod a maloobchod", "Zprostředkování obchodu a služeb", "Přípravné a dokončovací stavební práce, specializované stavební činnosti", "Výroba drážních hnacích vozidel a drážních vozidel na dráze tramvajové, trolejbusové a lanové a železničního parku", "Nakládání s odpady (vyjma nebezpečných)", "Výroba dalších výrobků zpracovatelského průmyslu", "Výroba školních a kancelářských potřeb, kromě výrobků z papíru, výroba bižuterie, kartáčnického a konfekčního zboží, deštníků, upomínkových předmětů", "Výroba strojů a zařízení", "Provozování cestovní agentury a průvodcovská činnost v oblasti cestovního ruchu", "Návrhářská, designérská, aranžérská činnost a modeling", "Projektování pozemkových úprav", "Poradenská a konzultační činnost, zpracování odborných studií a posudků", "Činnost informačních a zpravodajských kanceláří", "Poskytování technických služeb", "Praní pro domácnost, žehlení, opravy a údržba oděvů, bytového textilu a osobního zboží", "Provozování tělovýchovných a sportovních zařízení a organizování sportovní činnosti", "Provozování kulturních, kulturně-vzdělávacích a zábavních zařízení, pořádání kulturních produkcí, zábav, výstav, veletrhů, přehlídek, prodejních a obdobných akcí", "Mimoškolní výchova a vzdělávání, pořádání kurzů, školení, včetně lektorské činnosti", "Nakládání s reprodukčním materiálem lesních dřevin", "Testování, měření, analýzy a kontroly", "Výzkum a vývoj v oblasti přírodních a technických věd nebo společenských věd", "Projektování elektrických zařízení", "Příprava a vypracování technických návrhů, grafické a kresličské práce", "Pronájem a půjčování věcí movitých", "Poskytování software, poradenství v oblasti informačních technologií, zpracování dat, hostingové a související činnosti a webové portály", "Ubytovací služby", "Zasilatelství a zastupování v celním řízení", "Potrubní a pozemní doprava (vyjma železniční a silniční motorové dopravy)", "Fotografické služby", "Chov zvířat a jejich výcvik (s výjimkou živočišné výroby)", "Činnost odborného lesního hospodáře a vyhotovování lesních hospodářských plánů a osnov", "Výroba, opravy a údržba sportovních potřeb, her, hraček a dětských kočárků", "Výroba měřicích, zkušebních, navigačních, optických a fotografických přístrojů a zařízení", "Výroba kovových konstrukcí a kovodělných výrobků", "Výroba a hutní zpracování železa, drahých a neželezných kovů a jejich slitin", "Výroba plastových a pryžových výrobků", "Výroba hnojiv", "Výroba chemických látek a chemických směsí nebo předmětů a kosmetických přípravků", "Vydavatelské činnosti, polygrafická výroba, knihařské a kopírovací práce", "Výroba vlákniny, papíru a lepenky a zboží z těchto materiálů", "Výroba textilií, textilních výrobků, oděvů a oděvních doplňků", "Výroba krmiv, krmných směsí, doplňkových látek a premixů", "Poskytování služeb pro zemědělství, zahradnictví, rybníkářství, lesnictví a myslivost", "Výroba, obchod a služby jinde nezařazené", "Poskytování služeb osobního charakteru a pro osobní hygienu", "Opravy a údržba potřeb pro domácnost, předmětů kulturní povahy, výrobků jemné mechaniky, optických přístrojů a měřidel", "Překladatelská a tlumočnická činnost", "Nákup, prodej, správa a údržba nemovitostí" ] } ], "vat": { "status": "payer", "reliability": { "reliable": true, "unreliableFrom": null }, "bankAccounts": [ { "number": "55567899/2010" }, { "number": "CZ8920100000002301370338" }, { "number": "CZ1420100000002801976854" }, { "number": "CZ6620100000002902049945" } ], "history": [ { "vatNumber": "CZ04997476", "registrationType": "payer", "validFrom": "2017-09-01", "validTo": null, "isGroupRegistration": false } ] } }, "flags": { "isActive": true, "isVatPayer": true, "isVatSubject": false, "isInInsolvency": false } } ] }, "errors": [] } } } } } }, "400": { "description": "Bad Request.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 400 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 400 }, "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "oneOf": [ { "title": "Empty request body error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "BODY" ], "description": "Type of error.", "example": "BODY" }, "subtype": { "enum": [ "EMPTY" ], "description": "Subtype of error.", "example": "EMPTY" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Cannot process the request because of the empty body. Please check Foxentry.dev for more information." } } }, { "title": "Request body not JSON error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "BODY" ], "description": "Type of error.", "example": "BODY" }, "subtype": { "enum": [ "NOT_JSON" ], "description": "Subtype of error.", "example": "NOT_JSON" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Cannot process the request because the JSON is not valid. Please check Foxentry.dev for more information." } } }, { "title": "No request in request body error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "BODY" ], "description": "Type of error.", "example": "BODY" }, "subtype": { "enum": [ "NOT_JSON" ], "description": "Subtype of error.", "example": "NOT_JSON" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Your API call body does not contain any requests." } } }, { "title": "Request body too big error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "BODY" ], "description": "Type of error.", "example": "BODY" }, "subtype": { "enum": [ "TOO_BIG" ], "description": "Subtype of error.", "example": "TOO_BIG" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Your request length is bigger than allowed. Please contact us if you think this is a mistake." } } }, { "title": "Options parameter not supported error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "OPTIONS" ], "description": "Type of error.", "example": "OPTIONS" }, "subtype": { "enum": [ "PARAMETER_NOT_SUPPORTED" ], "description": "Subtype of error.", "example": "PARAMETER_NOT_SUPPORTED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Options parameter is not supported for this endpoint." } } }, { "title": "Option parameter value not supported error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "OPTIONS" ], "description": "Type of error.", "example": "OPTIONS" }, "subtype": { "enum": [ "PARAMETER_VALUE_NOT_SUPPORTED" ], "description": "Subtype of error.", "example": "PARAMETER_VALUE_NOT_SUPPORTED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Value in paramater is not valid. Please check Foxentry.dev for more information." } } }, { "title": "Options parameter not supported error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "CLIENT" ], "description": "Type of error.", "example": "CLIENT" }, "subtype": { "enum": [ "PARAMETER_NOT_SUPPORTED" ], "description": "Subtype of error.", "example": "PARAMETER_NOT_SUPPORTED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Options parameter is not supported for this endpoint." } } }, { "title": "Options parameter not supported error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "CLIENT" ], "description": "Type of error.", "example": "CLIENT" }, "subtype": { "enum": [ "PARAMETER_VALUE_NOT_SUPPORTED" ], "description": "Subtype of error.", "example": "PARAMETER_VALUE_NOT_SUPPORTED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Options parameter is not supported for this endpoint." } } }, { "title": "Request query empty error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "QUERY" ], "description": "Type of error.", "example": "QUERY" }, "subtype": { "enum": [ "NOT_SENT" ], "description": "Subtype of error.", "example": "NOT_SENT" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Your request query is empty. Please check Foxentry.dev for more information about how to set up the query properly." } } }, { "title": "Query parameter combination error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "QUERY" ], "description": "Type of error.", "example": "QUERY" }, "subtype": { "enum": [ "PARAMETERS_COMBINATION" ], "description": "Subtype of error.", "example": "PARAMETERS_COMBINATION" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to.", "example": "streetWithNumber" }, "example": [ "streetWithNumber", "street" ] }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "It is not possible to use these parameters at the same time in one request." } } }, { "title": "Request query parameter not supported for this query error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "OPTIONS" ], "description": "Type of error.", "example": "OPTIONS" }, "subtype": { "enum": [ "PARAMETER_NOT_SUPPORTED_FOR_QUERY" ], "description": "Subtype of error.", "example": "PARAMETER_NOT_SUPPORTED_FOR_QUERY" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to.", "example": "allowPartialResults" }, "example": [ "allowPartialResults" ] }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Parameter can not be used in combination with this query parameters." } } }, { "title": "Request options parameter combination error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "OPTIONS" ], "description": "Type of error.", "example": "OPTIONS" }, "subtype": { "enum": [ "PARAMETERS_COMBINATION" ], "description": "Subtype of error.", "example": "PARAMETERS_COMBINATION" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Combination of options or their values is not valid." } } }, { "title": "Query parameter missing error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "QUERY" ], "description": "Type of error.", "example": "QUERY" }, "subtype": { "enum": [ "PARAMETERS_MISSING" ], "description": "Subtype of error.", "example": "PARAMETERS_MISSING" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to.", "example": "prefix" } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Query parameter is missing. Please check Foxentry.dev for more information about how to set up the query properly." } } }, { "title": "Request query parameter not supported error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "QUERY" ], "description": "Type of error.", "example": "QUERY" }, "subtype": { "enum": [ "PARAMETERS_NOT_SUPPORTED" ], "description": "Subtype of error.", "example": "PARAMETERS_NOT_SUPPORTED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." }, "example": [ "unsupportedParameter" ] }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Query parameter is not supported for this endpoint." } } }, { "title": "Request query parameter required error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "QUERY" ], "description": "Type of error.", "example": "QUERY" }, "subtype": { "enum": [ "PARAMETERS_REQUIRED" ], "description": "Subtype of error.", "example": "PARAMETERS_REQUIRED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to.", "example": "email" } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "At least one of listed parameters is required." } } } ] } } } } ] } } } }, "401": { "description": "Unauthorized.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 401 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "title": "Request authorization error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "AUTH" ], "description": "Type of error.", "example": "AUTH" }, "subtype": { "type": [ "string", "null" ], "description": "Subtype of error." }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Invalid authorization credentials sent. Check Foxentry.dev for more information how to set up the AUTH properly." } } } } } } ] } } } }, "402": { "description": "Payment Required.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 402 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "title": "Request billing error - no credit", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "BILLING" ], "description": "Type of error.", "example": "BILLING" }, "subtype": { "enum": [ "NO_CREDIT" ], "description": "Subtype of error.", "example": "NO_CREDIT" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "No credit available. You need to purchase a sufficient amount of credits in the project administration at app.foxentry.com." } } } } } } ] } } } }, "403": { "description": "Forbidden.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 403 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "oneOf": [ { "title": "Invalid api key error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "AUTH" ], "description": "Type of error.", "example": "AUTH" }, "subtype": { "enum": [ "KEY" ], "description": "Subtype of error.", "example": "KEY" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Provided API key is not valid. Please check the project settings at app.foxentry.com." } } }, { "title": "Invalid access token error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "AUTH" ], "description": "Type of error.", "example": "AUTH" }, "subtype": { "enum": [ "TOKEN" ], "description": "Subtype of error.", "example": "TOKEN" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Provided access token is not valid. Please check the project settings at app.foxentry.com." } } }, { "title": "Domain not allowed error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "NOT_ALLOWED" ], "description": "Type of error.", "example": "NOT_ALLOWED" }, "subtype": { "enum": [ "DOMAIN" ], "description": "Subtype of error.", "example": "DOMAIN" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Website domain is not allowed in the project settings." } } }, { "title": "IP address not allowed error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "NOT_ALLOWED" ], "description": "Type of error.", "example": "NOT_ALLOWED" }, "subtype": { "enum": [ "IP" ], "description": "Subtype of error.", "example": "IP" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "The API key has IP limits set and your IP address is not allowed. Change the project settings at app.foxentry.com." } } } ] } } } } ] } } } }, "404": { "description": "Not Found.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 404 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "oneOf": [ { "title": "Api version not found error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "API_VERSION" ], "description": "Type of error.", "example": "API_VERSION" }, "subtype": { "type": [ "string", "null" ], "description": "Subtype of error." }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Requested API version is not available. Please check Foxentry.dev for the supported versions." } } }, { "title": "Endpoint not found error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "ENDPOINT" ], "description": "Type of error.", "example": "ENDPOINT" }, "subtype": { "enum": [ "NOT_FOUND" ], "description": "Subtype of error.", "example": "NOT_FOUND" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Endpoint not found. Please check Foxentry.dev for the supported endpoints." } } }, { "title": "Project not found error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "PROJECT" ], "description": "Type of error.", "example": "PROJECT" }, "subtype": { "enum": [ "NOT_FOUND" ], "description": "Subtype of error.", "example": "NOT_FOUND" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "The project does not exist. Please check the available projects at app.foxentry.com or contact the support." } } } ] } } } } ] } } } }, "405": { "description": "Method Not Allowed.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 405 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "type": "array", "items": { "title": "Request method not allowed error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "ENDPOINT" ], "description": "Type of error.", "example": "ENDPOINT" }, "subtype": { "enum": [ "NOT_ALLOWED" ], "description": "Subtype of error.", "example": "NOT_ALLOWED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "HTTP method is not allowed for this endpoint. Please check Foxentry.dev for more information." } } } } } } ] } } } }, "429": { "description": "Too Many Requests.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 429 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "oneOf": [ { "title": "Maximum service limit reached error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "BILLING" ], "description": "Type of error.", "example": "BILLING" }, "subtype": { "enum": [ "SERVICE_LIMIT_REACHED" ], "description": "Subtype of error.", "example": "SERVICE_LIMIT_REACHED" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "The maximum service limit has been reached. Move to the higher paying plan or allow requests over the subscription." } } }, { "title": "Daily credit limit reached error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "RATE_LIMIT" ], "description": "Type of error.", "example": "RATE_LIMIT" }, "subtype": { "enum": [ "CREDIT_PER_DAY" ], "description": "Subtype of error.", "example": "CREDIT_PER_DAY" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "The maximum daily limit has been reached. Adjust the settings in the project or wait until the limit is reset." } } }, { "title": "Daily credit limit per IP reached error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "RATE_LIMIT" ], "description": "Type of error.", "example": "RATE_LIMIT" }, "subtype": { "enum": [ "CREDIT_PER_IP" ], "description": "Subtype of error.", "example": "CREDIT_PER_IP" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "The maximum daily limit per IP address has been reached. Adjust the settings in the project or wait until the limit is reset." } } }, { "title": "Request rate limit reached error", "type": "object", "properties": { "group": { "enum": [ "REQUEST" ], "description": "Group of error.", "example": "REQUEST" }, "type": { "enum": [ "RATE_LIMIT" ], "description": "Type of error.", "example": "RATE_LIMIT" }, "subtype": { "enum": [ "TOO_MANY_REQUESTS" ], "description": "Subtype of error.", "example": "TOO_MANY_REQUESTS" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "The maximum allowed request rate limit has been reached. Check Foxentry.dev for more information or contact the support." } } } ] } } } } ] } } } }, "500": { "description": "Internal Server Error.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 500 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "oneOf": [ { "title": "Internal billing error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "BILLING" ], "description": "Type of error.", "example": "BILLING" }, "subtype": { "type": [ "string", "null" ], "description": "Subtype of error." }, "severity": { "type": "string", "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Failed to process your request due to a billing internal error. Please contact us if the error persists." } } }, { "title": "Database connection error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "DATABASE" ], "description": "Type of error.", "example": "DATABASE" }, "subtype": { "enum": [ "CONNECTION" ], "description": "Subtype of error.", "example": "CONNECTION" }, "severity": { "type": "string", "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Failed to establish connection with the database server. Please contact us if the error persists." } } }, { "title": "Internal database error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "DATABASE" ], "description": "Type of error.", "example": "DATABASE" }, "subtype": { "enum": [ "ERROR" ], "description": "Subtype of error.", "example": "ERROR" }, "severity": { "type": "string", "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "An error has occurred during the communication with our database. Please contact us if the error persists." } } }, { "title": "Database not available error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "DATABASE" ], "description": "Type of error.", "example": "DATABASE" }, "subtype": { "enum": [ "NOT_AVAILABLE" ], "description": "Subtype of error.", "example": "NOT_AVAILABLE" }, "severity": { "type": "string", "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Internal datastore is not available at the moment. No operation on this datastore is possible." } } }, { "title": "Internal server error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "ERROR" ], "description": "Type of error.", "example": "ERROR" }, "subtype": { "type": [ "string", "null" ], "description": "Subtype of error." }, "severity": { "enum": [ "CRITICAL" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "CRITICAL" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Failed to process your request. Please try again later or contact us." } } }, { "title": "API timeout error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "TIMEOUT" ], "description": "Type of error.", "example": "TIMEOUT" }, "subtype": { "type": [ "string", "null" ], "description": "Subtype of error." }, "severity": { "enum": [ "CRITICAL" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "CRITICAL" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "API timeout in effect. Your request took too much time to process." } } }, { "title": "Project data not available error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "PROJECT" ], "description": "Type of error.", "example": "PROJECT" }, "subtype": { "enum": [ "NO_DATA" ], "description": "Subtype of error.", "example": "NO_DATA" }, "severity": { "enum": [ "CRITICAL" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "CRITICAL" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "Failed to fetch project data needed for processing your request. Please contact us if the error persists." } } } ] } } } } ] } } } }, "503": { "description": "Service Unavailable.", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 503 } } }, { "type": "object", "properties": { "request": { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" } } }, { "type": "object", "properties": { "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": { "title": "Request endpoint not available error", "type": "object", "properties": { "group": { "enum": [ "INTERNAL" ], "description": "Group of error.", "example": "INTERNAL" }, "type": { "enum": [ "ENDPOINT" ], "description": "Type of error.", "example": "ENDPOINT" }, "subtype": { "enum": [ "NOT_AVAILABLE" ], "description": "Subtype of error.", "example": "NOT_AVAILABLE" }, "severity": { "enum": [ "critical" ], "description": "Severity of error. Info = cosmetic changes that don't change the overall meaning. Warning = typos and other errors that could affect the meaning. Critical = critical errors.", "example": "critical" }, "relatedTo": { "description": "List of the affected inputs.", "type": "array", "items": { "type": "string", "description": "Error related to." } }, "description": { "type": [ "string", "null" ], "description": "Description of error.", "example": "API endpoint is temporary unavailable. Please contact us at info@foxentry.com if the error persists." } } } } } } ] } } } } }, "security": [ { "BearerAuth": [] } ] } }, "/email/search": { "post": { "tags": [ "Email" ], "summary": "Search email", "description": "Foxentry will automatically offer you suggestions to complete the e-mail address you are writing down. This mainly serves as autocomplete.

Pay attention to the client section in the request body. You can specify the user's location in order to receive more relevant suggestions.", "operationId": "EmailSearch", "parameters": [ { "$ref": "#/paths/~1company~1get/post/parameters/0" }, { "$ref": "#/paths/~1company~1get/post/parameters/1" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "request": { "type": "object", "allOf": [ { "type": "object", "properties": { "customId": { "type": [ "string", "null" ], "description": "Custom ID assigned by you if you need so.", "example": "customer567914" }, "query": { "type": "object", "properties": { "value": { "type": "string", "example": "info@foxentry.com" } }, "required": [ "value" ] }, "options": { "type": "object", "description": "Query options.", "properties": { "resultsLimit": { "type": "number", "description": "Limits number of results returned by the endpoint.", "minimum": 1, "maximum": 5, "example": 5 } } }, "client": { "$ref": "#/paths/~1company~1get/post/requestBody/content/application~1json/schema/properties/request/allOf/0/properties/client" } } } ], "required": [ "query" ] } }, "required": [ "request" ] }, "examples": { "Request Example": { "value": { "request": { "query": { "value": "p.novak@" }, "options": { "resultsLimit": 5 }, "client": { "country": "CZ", "location": { "lat": 50.0628, "lon": 13.9271 } } } } } } } } }, "responses": { "200": { "description": "Successful response", "headers": { "foxentry-api-version": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-api-version" }, "foxentry-daily-credits-left": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-daily-credits-left" }, "foxentry-daily-credits-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-daily-credits-limit" }, "foxentry-rate-limit": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit" }, "foxentry-rate-limit-period": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-period" }, "foxentry-rate-limit-remaining": { "$ref": "#/paths/~1company~1get/post/responses/200/headers/foxentry-rate-limit-remaining" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "description": "Status of API response.", "example": 200 }, "request": { "allOf": [ { "type": "object", "properties": { "endpoint": { "example": "email/search" } } }, { "$ref": "#/paths/~1company~1get/post/responses/200/content/application~1json/schema/properties/request/allOf/1" }, { "$ref": "#/paths/~1email~1search/post/requestBody/content/application~1json/schema/properties/request/allOf/0" } ] }, "response": { "type": "object", "properties": { "resultsCount": { "type": "number", "description": "Number of results", "minimum": 1, "maximum": 5, "example": 1 }, "results": { "type": "array", "items": { "type": "object", "properties": { "data": { "type": "object", "properties": { "email": { "type": "string", "description": "Suggested e-mail", "example": "info@gmail.com" }, "user": { "type": "string", "description": "Suggested user", "example": "info" }, "domain": { "type": "string", "description": "Suggested domain", "example": "gmail.com" } }, "required": [ "email", "domain" ] } }, "required": [ "data" ] } } }, "required": [ "resultsCount", "results" ] }, "errors": { "description": "List of errors related to the request. Should be empty if the request finished successfully.", "type": "array", "items": {}, "maxItems": 0 } }, "required": [ "status", "request" ] }, "examples": { "searchResults": { "value": { "status": 200, "request": { "endpoint": "email/search", "code": "61903486-39f4-48ab-8d2d-a7a0381bca7c", "query": { "value": "info" }, "options": { "resultsLimit": 5 } }, "response": { "resultsCount": 5, "results": [ { "data": { "email": "info@seznam.cz", "domain": "seznam.cz" } }, { "data": { "email": "info@gmail.com", "domain": "gmail.com" } }, { "data": { "email": "info@email.cz", "domain": "email.cz" } }, { "data": { "email": "info@centrum.cz", "domain": "centrum.cz" } }, { "data": { "email": "info@post.cz", "domain": "post.cz" } } ] }, "errors": [] } } } } } }, "400": { "$ref": "#/paths/~1company~1get/post/responses/400" }, "401": { "$ref": "#/paths/~1company~1get/post/responses/401" }, "402": { "$ref": "#/paths/~1company~1get/post/responses/402" }, "403": { "$ref": "#/paths/~1company~1get/post/responses/403" }, "404": { "$ref": "#/paths/~1company~1get/post/responses/404" }, "405": { "$ref": "#/paths/~1company~1get/post/responses/405" }, "429": { "$ref": "#/paths/~1company~1get/post/responses/429" }, "500": { "$ref": "#/paths/~1company~1get/post/responses/500" }, "503": { "$ref": "#/paths/~1company~1get/post/responses/503" } }, "security": [ { "BearerAuth": [] } ] } } }, "tags": [ { "name": "Company", "description": "Company operations" }, { "name": "Email", "description": "Email operations" } ], "components": { "securitySchemes": { "BearerAuth": { "type": "http", "description": "Bearer token formatted API key. You can obtain the API key after the sign up at app.foxentry.com/registration.", "scheme": "bearer" } } }, "security": [ { "BearerAuth": [] } ] } ```