Returns businesses with postcode SW1A 2AA
| Where we have multiple addresses for a business, if any of them match the postcode filter then the business will be included in the search results. | | `distance` | Search within a specified radius of a UK postcode. |Returns businesses within a 3 mile radius of SW1A 2AA
| Where we have multiple addresses for a business, if any of them match the postcode filter then the business will be included in the search results. | |has\_contact
has\_phone\_contact
has\_email\_contact
Returns companies which have a contact phone number or a contact email address.
Returns companies which have a contact email address.
Returns companies with no contact email address but with a contact phone number.
| All of these filters take a boolean value; e.g. 'true' or 'false'. | | `exclude_non_trading` | Filter out non-trading companies (rated 'Discontinued', 'Dissolved', 'Not-trading' or 'Strike Off'). | `https://api2.redflagalert.net/v4/companies/?exclude_non_trading=true` | The filter does not return only non trading companies if set to 'false'. | | `has_filed_accounts` | Filter companies with accounting data i.e. who have filed accounts. | `https://api2.redflagalert.net/v4/companies/?has_filed_accounts=true` | Returns companies which have at least one set of figures for balance sheet, profit and loss, cashflow, or ratio analysis. Setting it to false will only return companies who have none of these data. | | `is_limited` | Filter search results to include/exclude registered/limited companies. |Only returns companies which are registered/limited.
| This filter takes a boolean value; e.g. 'true' or 'false'. | | `match_name` | A simple closest text match on the name of the business. |Will return Red Flag A!ert first, followed by other similar matches.
| | | `auditor` | Query on the name of the business's auditor | `https://api2.redflagalert.net/v4/companies/?auditor=begbies` | | | `auditor_match_name_prefix` | Match text at the beginning of the business's auditor | `https://api2.redflagalert.net/v4/companies/?auditor_match_name_prefix=begbies` | | | `match_name_prefix` | Also a text match, but focuses on the beginning of the company name. |Returns all businesses whose name starts with ‘red flag’.
| Most commonly used for autocomplete-style search | |min\_birthdate
max\_birthdate
Returns all businesses with current directors born in January, February or March 1987.
| Exact dates are not available for data protection reasons | |min\_employees
max\_employees
Returns all companies with between 5 and 50 employees.
| Can specify min or max parameters. To search within a range, specify both. | |min\_combined\_employees
max\_combined\_employees
Returns all companies with between 50 and 100 estimated or actual employees.
| | |min\_incorporation\_date
max\_incorporation\_date
Return companies established on or after the 9th of February 1987.
Return companies established between 1977 and 1987.
| Supply valid dates in ISO-8601 standard YYYY-MM-DD format. Can specify min or max parameters. To search within a range, specify both. | |min\_total\_assets
max\_total\_assets
Returns companies with most recently reported assets of between £50k and £100k.
| Can specify min or max parameters. To search within a range, specify both. | |min\_turnover
max\_turnover
Returns businesses with last reported turnovers of between £50k and £100k.
| Can specify min or max parameters. To search within a range, specify both. | |min\_combined\_turnover
max\_combined\_turnover
Returns all companies with between 50,000 and 100,000 estimated or actual turnover.
| | | `min_credit_limit` `max_credit_limit` | Range search on the `credit_limit` figure found in the `rfa_rating` section of a company | `https://api2.redflagalert.net/v4/companies/?min_credit_limit=50000&max_credit_limit=100000` | | | `min_credit_score` `max_credit_score` | Range search on the `credit_score` figure found in the `rfa_rating` section of a company (0 to 100) | `https://api2.redflagalert.net/v4/companies/?min_credit_score=75&max_credit_score=90` | | | `min_last_filed_accounts` `max_last_filed_accounts` | Range search on the date the company last filed their accounts in YYYY-MM-DD format | `https://api2.redflagalert.net/v4/companies/?min_last_filed_accounts=2020-05-30` | | | `has_directorships` | Filters companies that have at least one directorship record. | `https://api2.redflagalert.net/v4/companies/?has_directorship=true` | | |sic\_section
sic\_section\_search\_type
Returns all construction businesses in the database.
Multiple section can be searched, in which case results will containe businesses that have any of the supplied codes:
In order to only get results that match all of the supplied sectors, supply the 'sic\_section\_search\_type' parameter:
sic\_code
sic\_code\_search
primary\_sic\_code
Returns companies with the SIC code 51519.
Returns companies with the SIC code 51519 or 51511.
Returns companies with at least the SIC codes 51519 and 51511 assigned.
Returns companies whose primary SIC code is 51519.
Returns companies whose primary SIC code is 51519 or 51511.
|You can supply multiple search parameters, comma separated in list.
By default, a search on a sic\_code will return companies that have any of the listed SIC codes. If you would like to see only companies that have all of the supplied SIC codes, supply the 'sic\_code\_search\_type' parameter ate to 'and' (if not supplied, defaults to 'or').
SIC codes for companies are returned in order of priority, the primary SIC code being the first entry in the list. The primary SIC code itself is a searchable field. Multiple values can be supplied that will match a company that has any one of them as the primary SIC code. Only one value can be present for the 'primary\_sic\_code' therefore you cannot perform an 'and' search on this field as with 'sic code'.
| | `rating` | The Red Flag Alert credit rating currently assigned to this company. |Returns companies with the specified Red Flag rating e.g:
Returns companies with a 'Bronze' Red Flag rating.