Search CNRC activity codes
search_activity_codesSearch the official Algerian nomenclature of commercial activities kept by the CNRC (Centre National du Registre du Commerce): the six-digit codes written on a trade register entry. Use it to find the code of an activity described in French, Arabic or English, to read the CNRC status of an activity (libre, reglementee or bloquee: meta.status_note says what each means and what it does not prove) or to browse the activities of a sector. The status, the authority, the authorization and the references of a code are the CNRC's own, from its nomenclature of economic activities (NAE, executive decree 15-249 of 29 September 2015, content updated by order of the minister of commerce); that nomenclature is not a list of the activities that need a licence, and a libre code may still need a sector title. get_activity_code adds details.jo_check where UpGrowth found the Journal officiel contradicting or not settling the CNRC text. Returns a page of activities, each with its code, status, labels in the three languages, sector, group and the URL of its page on upgrowth.dz. meta.total is the number of matches. For Tunisia (country TN) it searches the official Tunisian nomenclature of activities, the NAT 2009 of the national statistics institute (INS): four-digit class codes (01.11 is written 0111), labels in French only, a section letter A to U as sector, each record citing its official source. The NAT is a statistical classification, not the list of activities that need an authorization: the status comes from a hand-reviewed map of its classes to the authorisations of annex 1 of décret 2018-417, the exclusive list (reglementee with the authorisations and their legal references, libre because the list is exclusive), never libre by default: without the map the status is not_determined. With list=authorisations it searches the authorisations themselves. Tunisia needs an API key. For Morocco (country MA) it searches the official NMA 2010 nomenclature of the Haut-Commissariat au Plan instead: four-digit codes, labels in French, the section letter A to U as sector, the branch and the sub-branch as group; the nomenclature is statistical and gives no authorization regime, so every Moroccan code has the status not_determined, never free. Morocco needs an API key. Without an API key at most 10 rows come back and meta.truncated says when more matched, so do not present such a list as complete. Every row carries its own status, but a truncated list can hide a regulated or blocked code: search again with status=reglementee or status=bloquee, or read get_activity_code, before calling an activity free.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search text, at most 100 characters. Digits only, for example 5011: matches the activity codes that start with them. Words: every word must start a word of the activity label in French, Arabic or English, so a few specific words work best. Accents and letter case are ignored. Leave it out to browse with the other filters. | |
| lang | No | Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English). | fr |
| list | No | Tunisia only (country TN): nat (the default) searches the classes of the NAT 2009; authorisations searches the 100 authorisations of annex 1 (and the 27 of annex 2, those to be struck out) of décret gouvernemental n° 2018-417 of 11 May 2018, as records with their conditions, procedures, delays and legal references. Ignored for Algeria and Morocco. Get one with get_activity_code and a code such as A1-017. | nat |
| limit | No | Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back. | |
| offset | No | Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged. | |
| sector | No | Keep only activities of this sector. Algeria: the CNRC sector, given as its digit: 1 goods production, 2 artisanal production, 3 wholesale distribution, 4 import for resale, 5 retail distribution, 6 services, 7 export. Tunisia (country TN): the section letter of the NAT 2009, A to U, for example C for manufacturing. For Morocco (country MA): the section of the NMA 2010 as its letter, A to U (for example C for manufacturing, G for trade). | |
| status | No | Keep only activities with this status: libre (the CNRC does not mark the code as regulated: not proof that no sector licence is needed), reglementee (regulated: the authorization or agrément that the text of the activity sets is required to exercise it) or bloquee (blocked: a status of the CNRC nomenclature, understood as not registrable under that code; no text of the Journal officiel read defines it and the data does not give the reason). For Tunisia (country TN): reglementee when an authorisation of annex 1 of décret 2018-417 governs the class, libre otherwise (the annex is the exclusive list), not_determined when that map is not loaded. | |
| country | No | Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required. | DZ |