Business public data for Algeria, Tunisia and Morocco as an API and an MCP connector
UpGrowth maintains business public data for Algeria, Tunisia and Morocco and serves it two ways: as a REST API for developers, and as an MCP connector for AI assistants. For Algeria it covers the CNRC activity codes with their status, the ANAE auto-entrepreneur activities, the 58 historic wilayas, the full text of the Journal officiel, the six DGI tax codes, the rules on VAT, the tax calendar and support schemes, the communes, postal codes and post offices, the dairas, the customs tariff sections and chapters, the legal forms and the CASNOS and IFU 2026 calculators. Tunisia and Morocco have their official gazette index, their activity nomenclature, tax, social contributions, the auto-entrepreneur regime and legal forms: the detail is in the Countries live section. Three countries are live: Algeria, Tunisia and Morocco. The free tier is for AI assistants, through the MCP connector: it needs no key and no sign-in, and it covers Algeria only, with the Journal officiel of recent years. Every issue since 1962, in full text, comes with a plan, with the trial. Tunisia and Morocco need an API key, which you can try with the trial form on the page.
Connect in three steps
The free tier needs no sign-in. Pick your tool.
1. Claude: add the connector
Add it from Claude's connector directory, or as a custom connector with the address below: in claude.ai, open Settings, then Connectors, then Add custom connector. No sign-in is asked.
https://www.upgrowth.dz/mcp
2. Claude Code: one command
Run it in your terminal.
claude mcp add --transport http upgrowth https://www.upgrowth.dz/mcp
3. REST API: one curl call
The base URL is https://www.upgrowth.dz/api/v1. This route is free.
curl https://www.upgrowth.dz/api/v1/wilayas
Free tier
- 30 calls a day per MCP session
- REST: 20 calls a day per IP address
- Algeria data only
- Journal officiel: the current year and the 2 years before it
- Searches return 10 rows
- Calculators are free
- Attribution to upgrowth.dz
With a paid key
- Every live country: Algeria, Tunisia, Morocco
- The Journal officiel since 1962, with the French full text
- Full result pages
- Regulatory alerts
Professional: $3,900 a year, or 390,000 DA excl. VAT a year, or 39,000 DA excl. VAT a month.
14-day Professional trial, 1,000 calls. Start the free trial
Send the key in the header Authorization: Bearer <key>. The bare key works too.
What the data covers
Public data only: nothing about customers, leads or individuals. Each answer says which dataset it comes from, under which licence, and the date of the snapshot.
CNRC activity codes
Search the nomenclature by code or by word, in French, Arabic and English. Each code carries its status (free, regulated or blocked) and the address of its page on upgrowth.dz.
/activities
ANAE activities
The auto-entrepreneur activities, by domain, with their labels in French, Arabic and English.
/anae-activities
The 58 historic wilayas
Every wilaya by code, with its name in French, Arabic or English. The 11 wilayas created in April 2026 are not in it yet. Presidential decree no. 26-206 of 25 May 2026 numbers them 59 to 69.
/wilayas
Journal officiel, full text
Every act of the French edition, from 1962 to 2026, searchable in its text and readable in full. From 2002 to 2026 the text comes from the official PDFs. From 1962 to 2001 it was read from the scans: those acts carry the source "scan" and unreadable passages are flagged as uncertain. The Arabic edition is not yet in full text. Around it: the index of issues by year, the tables of contents and a search over their titles, copied from joradp.dz. The free tier covers the same window of years as the rest of the Journal officiel.
/journal-officiel/text/search/journal-officiel/acts/journal-officiel/years/journal-officiel/search
Customs tariff
The sections and chapters of the customs tariff nomenclature, with titles in French, English and Arabic. The nomenclature only: it carries no duty rates.
/customs-tariff/sections
Legal forms
For each legal form: the number of partners, the minimum capital and the State fees. No UpGrowth fee in this answer.
/creation/legal-forms
CASNOS 2026 calculator
The 2026 CASNOS contribution, computed with the arithmetic of the calculator on upgrowth.dz. The answer details the calculation up to the result. It is an estimate from public texts, not tax advice.
/calculators/casnos
IFU 2026 calculator
The 2026 IFU, computed with the arithmetic of the calculator on upgrowth.dz. The answer gives the base, the rate and the minimum when it applies. It is an estimate from public texts, not tax advice.
/calculators/ifu
DGI tax codes
The six 2026 codes of the DGI: CIDTA, CPF, CTCA, the registration code, the indirect taxes code and the stamp code. 2,384 articles, searchable and readable article by article. Source: mfdgi.gov.dz.
/tax-codes
Rules: VAT, tax calendar, support schemes
The VAT regimes, the tax calendar and the support schemes, as rules you can read and cite. Each item cites the act that establishes it.
/rules/vat
Communes, postal codes and post offices
The communes, their postal codes and the post offices, from Algérie Poste's public data, refreshed daily.
/communes/communes/{code}/post-offices
Dairas
The list of dairas and, on each commune, its daira, built from décret 91-306 and its amendments up to 26-253, for the 69 wilayas.
/communes
Countries live
Our data API and MCP server are live for Algeria, Tunisia and Morocco, expanding to more African countries and the whole MENA region. Algeria answers with no key, within the limits of the free tier. Tunisia and Morocco need an API key. Choose the country with the country parameter (DZ by default, TN or MA).
Algeria
Free tier, or API key
- The full text of every act of the Journal officiel since 1962, searchable, with the link to the official PDF: 1962 to 2001 read from the scanned issues, with unsettled passages marked
- The index and summaries of every Journal officiel issue since 1962
- The six 2026 tax codes of the DGI, article by article: CIDTA, CPF, CTCA, registration, indirect taxes and stamp duty
- CNRC activity codes checked against the Journal officiel, and the ANAE auto-entrepreneur list
- VAT regimes with their articles, and the tax and social filing calendar
- Support schemes and investment rules (law 22-18)
- CASNOS and IFU estimates
- Legal forms and State fees
- Customs tariff: sections and chapters
- The 69 wilayas, the dairas and the communes
- Algérie Poste post offices and ATMs, refreshed daily
Tunisia
API key required
- Index of the Journal Officiel de la République Tunisienne (JORT) since 1956
- NAT activity nomenclature, with the authorisations of décret 2018-417
- Governorates and institutions
- Legal forms, with the official fees
- Tax rates
- Social contributions, and the CNSS calculator for the self-employed
- Auto-entrepreneur regime and its single contribution
- Customs tariff: sections and chapters
Each activity class is regulated, with the authorisations of décret 2018-417 that govern it, or free.
Morocco
API key required
- Bulletin officiel index since 1912, in French and Arabic
- NMA activity nomenclature
- Regions and institutions
- Legal forms
- Tax rates
- Social contributions
- Auto-entrepreneur regime, excluded professions and auto-entrepreneur tax
The activity codes have no status yet (free or regulated).
Every answer cites its official source: gazette, issue, page, link.
Your country next
Not live yet: these regions. No date. The live countries are Algeria, Tunisia and Morocco. A new country opens when a request justifies it: yours counts.
OHADA
Not live yet
The uniform acts: the company law common to 17 member states, from the official OHADA source.
Senegal
Not live yet
Côte d'Ivoire
Not live yet
Egypt
Not live yet
Saudi Arabia
Not live yet
United Arab Emirates
Not live yet
Nigeria
Not live yet
Kenya
Not live yet
Run a real query
Type a word, pick the source and send the call: the page queries the API live, with no key. The API is live for Algeria, Tunisia and Morocco; the free tier covers Algeria.
Without a key: 20 calls a day per IP address on REST, 30 a day per session on MCP, Algeria data only, the Journal officiel of the current year and the 2 years before it, at most 10 rows per search.
Quick start
The base URL is https://www.upgrowth.dz/api/v1. Every route answers a GET request with JSON. Without a key you are on the free tier: nothing to create, nothing to install. It covers Algeria only: its limits are in the Plans section.
The API is open to every origin (CORS) and sets no cookie, so you can call it from a browser.
1. Search activity codes
The q parameter takes the start of a code or words from the label, in any of the three languages, with or without accents. Leave q out to browse with the other filters.
curl "https://www.upgrowth.dz/api/v1/activities?q=boulangerie&lang=fr&limit=3"
2. Read one code
The answer sits in an envelope: data holds the content, meta holds the source, the licence, the line to credit, the date of the snapshot and help, the call to action to relay to the user.
curl "https://www.upgrowth.dz/api/v1/activities/202407?lang=en"
{
"data": {
"code": "202407",
"status": "libre",
"label": {
"fr": "boulangerie pâtisserie artisanale",
"ar": "مخبزة و حلويات تقليدية",
"en": "Artisan pastry bakery"
},
"sector": {
"code": "2",
"label": "Artisanal Production"
},
"url": "https://www.upgrowth.dz/en/business-activity/boulangerie-patisserie-artisanale-202407"
},
"meta": {
"dataset": "cnrc-2026",
"source": "CNRC Nomenclature 2026 of economic activity codes",
"source_url": "https://www.upgrowth.dz/en/datasets/cnrc-2026",
"licence": "CC BY 4.0",
"licence_url": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "Data from UpGrowth (https://www.upgrowth.dz), credit with a link.",
"updated": "YYYY-MM-DD",
"help": {
"text": "To set up your company or your auto-entrepreneur status with this activity, UpGrowth can handle this for you.",
"url": "https://www.upgrowth.dz/contact?service=creation&source=api"
}
}
}Abridged: the real answer also carries the group and a details block with the official text of the code.
3. Run a calculator
The calculators take the same inputs as the pages of the site. The regime parameter is required. The answer gives the base, the rate and the contribution, with the limits of the estimate in data.limitations and a reminder in meta.disclaimer.
curl "https://www.upgrowth.dz/api/v1/calculators/casnos?revenue=3000000®ime=FORFAITAIRE_ACHAT_VENTE&year=2026"
The answer envelope
The call to action to relay
Choose the language
Rate limit headers
With a paid key
Send your key in the Authorization header. A malformed header is refused with a 401 error, never silently ignored.
curl -H "Authorization: Bearer ugk_YOUR_KEY" "https://www.upgrowth.dz/api/v1/wilayas"
OpenAPI file
The OpenAPI 3.1 file describes every route, parameter and response. Import it into your HTTP client or your code generator. It and the API index do not count against your limit.
Open openapi.jsonErrors
An error is an object { error: { code, message } } with the matching HTTP status. It is never cached.
- 400
invalid_parameterA parameter is invalid. The message says what to fix. - 401
invalid_keyUnknown or revoked key, or a malformed Authorization header. - 404
not_foundUnknown route or code. - 403
key_requiredOutside the free tier: a country other than Algeria, a Journal officiel year that is too old, or offset on a search. An API key is needed. - 403
trial_endedThe trial of this account is over. - 429
free_quota_exceededThe free tier limit is reached for the day. - 429
quota_exceededThe daily limit of the key is reached. - 429
trial_quotaThe calls of the trial are used up. - 429
rate_limitedToo many requests in a short time: slow down. - 503
unavailableA keyed call cannot be counted right now: retry in a moment. - 503
data_unavailableThe data is not available right now: retry later.
{
"error": {
"code": "not_found",
"message": "No activity code 999999 in the CNRC nomenclature"
}
}API routes
Every route answers GET under https://www.upgrowth.dz/api/v1 and accepts lang (fr, ar or en, fr by default). The search routes also accept q (up to 100 characters), limit (1 to 100, 20 by default) and offset (0 to 10,000). This table gives the core routes: the OpenAPI file (see the quick start) lists every route and every parameter, including the tax codes, the rules, the communes, the Journal officiel full text and the multi-country routes.
- GET
/activitiesParameters: q, lang, status, sector, limit, offset
Search CNRC activity codes. status: libre, reglementee or bloquee. sector: the sector digit, 1 to 7.
- GET
/activities/{code}Parameters: lang
One six-digit CNRC activity code.
- GET
/anae-activitiesParameters: q, lang, domain, limit, offset
Search ANAE activities. domain: the six-digit domain code.
- GET
/anae-activities/{code}Parameters: lang
One six-digit ANAE activity.
- GET
/wilayasParameters: lang
The 58 historic wilayas.
- GET
/wilayas/{code}Parameters: lang
One wilaya, by its two-digit code.
- GET
/journal-officiel/yearsParameters: lang
The years of the Journal officiel index.
- GET
/journal-officiel/searchParameters: q, lang, year, limit, offset
Search the titles in the tables of contents, with year as an option.
- GET
/journal-officiel/{year}/issuesParameters: lang
The issues of a year, with links to the official editions.
- GET
/journal-officiel/{year}/{number}Parameters: lang
One issue, with its table of contents when UpGrowth holds it.
- GET
/customs-tariff/sectionsParameters: lang
The sections of the customs tariff.
- GET
/customs-tariff/sections/{section}/chaptersParameters: lang
The chapters of a section, given by its Roman numeral (XVI, for example).
- GET
/creation/legal-formsParameters: lang
The legal forms: number of partners, minimum capital and State fees. No UpGrowth fee.
- GET
/calculators/casnosParameters: revenue, regime, year, lang
CASNOS 2026 contribution. regime is required: FORFAITAIRE_ACHAT_VENTE, FORFAITAIRE_PRESTATIONS, BENEFICE_REEL, AUTO_ENTREPRENEUR or PREMIERE_ANNEE.
- GET
/calculators/ifuParameters: turnover, regime, activity, lang
IFU 2026. regime: ae or general. activity: production, commerce or services, required with general.
MCP connector for AI assistants
The same data as tools an assistant can call on its own. The server speaks MCP over Streamable HTTP and needs no sign-in on the free tier. A tool call counts as one call, like a REST call; listing the tools does not count. The connector is listed in Claude's connector directory and in the official MCP registry, and UpGrowth is a member of Anthropic's Claude Startups program.
https://www.upgrowth.dz/mcp
Free tier: 30 calls a day per MCP session, when the client sends back the Mcp-Session-Id header that initialize returns; otherwise 20 calls a day per IP address, as on REST. Counters reset at 00:00 UTC. It covers Algeria only. A search returns at most 10 rows, with a note saying the list is not complete. For the Journal officiel, it gives the current year and the 2 years before it. Every issue since 1962, in full text, comes with a plan, with the 14-day trial, which starts with the trial form.
Claude
Open Settings, then Connectors, choose Add custom connector, give it a name and paste the server URL.
ChatGPT
Turn on developer mode in the connector settings, create a connector and paste the server URL. Menu names change: if a label differs, follow OpenAI's current help page.
Cursor
Add the server to your mcp.json file, global or per project.
{
"mcpServers": {
"upgrowth-algeria-data": {
"url": "https://www.upgrowth.dz/mcp"
}
}
}VS Code
Add the server to the .vscode/mcp.json file of your project.
{
"servers": {
"upgrowth-algeria-data": {
"type": "http",
"url": "https://www.upgrowth.dz/mcp"
}
}
}A client that lets you set a header can send Authorization: Bearer ugk_... to use a paid plan's limit. Other clients stay on the free tier, which does not cover Tunisia or Morocco.
The tools
30 tools, all read only: they change nothing. Each accepts an optional lang parameter (fr, ar or en).
search_activity_codesSearch CNRC activity codes by code or by words.
get_activity_codeRead one CNRC activity code and its status.
search_anae_activitiesSearch the ANAE auto-entrepreneur activities.
get_anae_activityRead one ANAE activity.
list_wilayasList the wilayas.
get_wilayaRead one wilaya by its code.
list_jo_yearsList the years of the Journal officiel index.
list_jo_issuesList the issues of a year.
get_jo_issueRead one issue and its table of contents.
search_jo_titlesSearch the titles in the tables of contents.
customs_tariff_sectionsList the customs tariff sections.
customs_tariff_chaptersList the chapters of a section.
creation_legal_formsList the legal forms, their minimum capital and the State fees.
calculate_casnosEstimate the 2026 CASNOS contribution.
calculate_ifuEstimate the 2026 IFU.
list_countriesList the live countries: Algeria, Tunisia and Morocco.
get_tax_ratesRead the tax rates of a country.
get_social_contributionsRead the social contributions of a country.
list_institutionsList the institutions of a country.
get_vat_regimesRead the VAT regimes, each with the act that establishes it.
get_tax_calendarRead the tax calendar, each deadline with its act.
get_support_schemesRead the support schemes, each with its act.
search_jo_textSearch the full text of the Journal officiel acts, from 1962 to 2026.
get_jo_actRead one Journal officiel act in full text.
list_communesList the communes, with their postal code and daira.
get_communeRead one commune by its code.
search_post_officesSearch the Algérie Poste post offices.
list_dairasList the dairas.
search_tax_codeSearch the six DGI tax codes.
get_tax_code_articleRead one article of a DGI tax code.
Delivery, e-commerce and banks
A delivery company, an online shop or a bank needs every Algerian commune in its checkout, its routing and its map. The API and the MCP connector serve them.
The whole territory
The 69 wilayas, every commune with its postal codes and its daira, and every Algérie Poste post office and ATM with its address and GPS position.
Fresh every day
The Algérie Poste data is read every day. The dairas come from the decrees published in the Journal officiel.
Where it plugs in
- An address form: the commune, the postal code and the daira fill in and are checked.
- A delivery zone: the communes of a daira or of a wilaya.
- A cash-on-delivery point finder: the post office or ATM nearest to a GPS position.
The Team and the API and Platform plans, further down, are the ones for the teams and the software that plug this data into production. See the plans
Our data API and MCP server cover Algeria, Tunisia and Morocco, and more African and MENA countries are coming. The communes, post offices, ATMs and dairas described here are the Algerian data.
Licence and attribution
What you may reuse, under which licence, and what you must credit.
Under CC BY 4.0
These reference datasets are released under Creative Commons Attribution 4.0. Reuse them on the terms of the licence: credit UpGrowth with a link, give the link to the licence and say if you changed the data.
- CNRC 2026 nomenclatureRoute:
/activities - ANAE 2026 activitiesRoute:
/anae-activities - The 58 historic wilayasRoute:
/wilayas - The Journal officiel archive index (our data, not the PDFs or the official titles)Route:
/journal-officiel/years - The customs tariff sections and chaptersRoute:
/customs-tariff/sections
What we cannot license
The Journal officiel PDFs and the official titles belong to the Secrétariat général du Gouvernement (joradp.dz). The tables of contents the API returns copy those titles word for word: they are not ours, and no UpGrowth licence covers them.
The calculators
These are estimates computed from public texts, not tax advice. The rates and rules are our reading of those texts, and no open licence is attached to them.
Credit UpGrowth with a link
Every reuse credits UpGrowth with a link to https://www.upgrowth.dz. Each answer carries the line to use, in meta.attribution:
Data from UpGrowth (https://www.upgrowth.dz), credit with a link.
Plans
The data works inside your own tools: the API plugs into your systems (CRM, ERP, compliance, analytics), the MCP server into your internal AI agents and assistants, and it is also available in Claude. Every paid plan is a yearly subscription. For Essentiel, Professional and Team, the price shown is the price: no call and no quote to wait for. Foreign clients pay yearly by bank transfer. Algerian clients pay in DZD, excluding VAT (19 % added). Alerts, webhooks and the test environment open with the first contracts.
Free
Free
for AI assistants
- Claude, ChatGPT and other assistants, through our MCP server
- Algeria only: Tunisia and Morocco need an API key
- Journal officiel: the current year and the 2 years before it
- Searches: at most 10 rows, with a note saying the list is not complete
- The complete reference lists (wilayas, legal forms, customs tariff sections and chapters) stay whole
- The calculators are free
- 30 calls a day per MCP session, 20 a day per IP address on REST
- Counters reset at 00:00 UTC
- Credit UpGrowth with a link
- No free accounts for individuals
Every issue of the Journal officiel since 1962, in full text, comes with a plan. The 14-day trial starts by itself with the trial form on this page. Free 14-day trial (1,000 calls)
Essentiel
99,000 DA
excl. VAT a year
Or 9,900 DA excl. VAT a month. VAT 19 % added.
Algeria only
For professionals based in Algeria; companies abroad: Professional
- 1 user
- Algeria only
- The full texts of the Journal officiel and their search, on the site and in your own AI assistant (MCP)
- The calculators
- 1 alert topic by e-mail
- No API key
Pay by transfer to the company's AGB account or in cash by appointment, at your premises; from abroad, Wise, recorded as a cash payment at the Banque d'Algérie rate.
Professional
$3,900
a year
In Algeria: 390,000 DA excl. VAT a year, or 39,000 DA excl. VAT a month. VAT 19 % added.
- 1 named user
- 500 API calls a day
- Algeria, Tunisia and Morocco
- Full data
- The calculators
- The Journal officiel index
- The full text of the Algerian Journal officiel, 1962 to 2026, in French, act by act (1962 to 2001 read from the scans, flagged where uncertain)
- The six 2026 tax codes, article by article
- In AI assistants and through the API
- Alerts for 2 countries, open with the first contracts
Free 14-day trial (1,000 calls)
Pay by transfer to the company's AGB account or in cash by appointment, at your premises; from abroad, Wise, recorded as a cash payment at the Banque d'Algérie rate.
Team
$14,900
a year
In Algeria: 1,490,000 DA excl. VAT a year. VAT 19 % added.
- Up to 5 users
- Every alert, open with the first contracts
- 5,000 API calls a month
- Webhooks, open with the first contracts
- A 1-hour briefing each quarter
- WhatsApp support within 4 hours
Pay by transfer to the company's AGB account or in cash by appointment, at your premises; from abroad, Wise, recorded as a cash payment at the Banque d'Algérie rate.
API and Platform
from$24,000
a year
In Algeria: from 2,400,000 DA excl. VAT a year. VAT 19 % added. Priced offer on receipt of your answers.
- For software and AI products
- 25,000 calls a month
- A service level
- A test environment, open with the first contracts
Pay by transfer to the company's AGB account or in cash by appointment, at your premises; from abroad, Wise, recorded as a cash payment at the Banque d'Algérie rate.
Data licence
from$60,000
a year
Priced offer on receipt of your answers.
- Bulk delivery of the data
- Redistribution rights
- Priced per region
Pay by transfer to the company's AGB account or in cash by appointment, at your premises; from abroad, Wise, recorded as a cash payment at the Banque d'Algérie rate.
One-off
- Market entry dossier, per country
- $4,900
- Answer memo to one regulatory question
- $1,200
14-day trial
Try paid access before you commit. The trial gives the scope of the Professional plan for 14 days, capped at 1,000 calls in total: it ends as soon as either limit is reached. It is for companies: give your business e-mail address in the form below, the link that starts the trial is sent to you by e-mail and the key arrives by e-mail. Alerts, webhooks and the test environment open with the first contracts: they are not part of it.
Founding offer
The first 10 clients get 40 % off for 12 months, in exchange for a named case study.
Start the 14-day trial
The scope of the Professional plan for 14 days, capped at 1,000 calls. The trial is for companies: enter your work e-mail, the link that starts the trial and the key reach you by e-mail, with nothing else to do.
After the trial: Professional, $3,900 a year (Algeria: 390,000 DA HT a year or 39,000 DA HT a month, VAT 19 % on top).
Already an Essentiel client? Access your data
Data licence for AI labs and AI apps
For AI labs, AI apps, legal-tech and research teams that need official business-law data with its sources.
What the licence covers
Datasets
- CNRC activity codes
- ANAE activities
- The 58 historic wilayas
- Journal officiel, full text
- Customs tariff
- Legal forms
- DGI tax codes
- Rules: VAT, tax calendar, support schemes
- Communes, postal codes and post offices
- Dairas
Countries
- Algeria
- Tunisia
- Morocco
What the licence cannot cover is stated in the Licence section. See the Licence section
What the licence gives you
- Bulk delivery of the data, under contract
- The official source cited on every record
- Updates to this data
Price
from$60,000
a year per region
In Algeria: from 6,000,000 DZD excl. VAT a year per region, 19 % VAT on top.
Request the licence
Pay by transfer to the company's AGB account or in cash by appointment, at your premises; from abroad, Wise, recorded as a cash payment at the Banque d'Algérie rate.
What the data licence contains
For AI labs, AI answer engines, legal-tech and compliance AI teams, banks and telecoms that need official business-law data, with the source on every record.
The data, by family
Algeria
- The Journal officiel in full text since 1962, in French, with the Arabic edition of each issue referenced
- The 2026 tax codes, article by article
- The activity nomenclatures
- The communes, the dairas and the post offices
- The VAT regimes and the business support schemes
Tunisia and Morocco
- The indexes of the Tunisian Journal officiel and of the Moroccan Bulletin officiel
- The datasets of each country: regions, company legal forms, tax rates, social contributions and public bodies
The platform is live for Algeria, Tunisia and Morocco, and more African and MENA countries are coming. Each region is licensed separately.
Formats and updates
- JSONL files, one per country and per dataset
- Updated every day
- Delivered in bulk, under contract
The source on every record
Every record says where it comes from:
- The gazette
- The issue
- The page
- The official URL of the document
- The reading method
1962 to 2001: read from the scans
For the issues of 1962 to 2001 the text was read from the scans. A passage the readings do not settle is flagged as uncertain: check it on the official PDF before quoting it. From 2002 the text is the one of the official PDF.
The use covered
- Grounding a model's answers in official sources
- Retrieval of passages
- Evaluation of models
Training rights are priced on quote.
Price
from$60,000
a year per region
In Algeria: from 6,000,000 DZD excl. VAT a year per region, 19 % VAT on top.
The button opens the request form with the API service and the data licence already chosen.
Check the dataset yourself
Frequently asked questions
Is the API free?
There is a free tier, with no key, made for AI assistants and served by the MCP connector, with credit to UpGrowth. It covers Algeria only, the Journal officiel of the current year and the 2 years before it, and returns at most 10 rows on a search, with a note saying the list is not complete. The complete reference lists stay whole and the calculators are free. The limit is 30 calls a day per MCP session, or 20 calls a day per IP address on REST. There are no free accounts for individuals. Every issue of the Journal officiel since 1962, in full text, comes with a plan, with the 14-day trial, which starts by itself with the trial form. The paid plans are yearly: Professional and Team are ordered on this page, paid by transfer to the AGB account or in cash; for API and Platform, describe your need in the form on this page and the offer comes by e-mail.
What happens when the free limit is reached?
The API answers a 429 free_quota_exceeded error, with the Retry-After header in seconds. The counter resets at 00:00 UTC. To carry on without waiting, order a yearly plan on this page.
What happens outside the free scope?
The API answers a 403 key_required error, whose message says what needs a key: a country other than Algeria, a Journal officiel year older than the free ones, or the offset parameter on a search. The refused call counts against your limit for the day. To lift these limits, order a yearly plan or start the trial.
Can I try paid access?
Yes, with a 14-day trial: the scope of the Professional plan, capped at 1,000 calls in total. It is for companies: start it with the form in the Plans section, with your business e-mail address, and the key is sent to you by e-mail. Alerts, webhooks and the test environment open with the first contracts: they are not part of it.
How much do the paid plans cost?
Essentiel, for companies in Algeria only: 99,000 DA excl. VAT a year, or 9,900 DA excl. VAT a month, VAT 19 % added. Professional: $3,900 a year (390,000 DA a year in Algeria, or 39,000 DA a month). Team: $14,900 a year (1,490,000 DA a year in Algeria), up to 5 users and 5,000 API calls a month. API and Platform: from $24,000 a year (from 2,400,000 DA in Algeria). Data licence: from $60,000 a year (from 6,000,000 DA excl. VAT a year per region in Algeria). One-off: $4,900 for a market entry dossier, per country, and $1,200 for an answer memo to one regulatory question. Foreign clients pay yearly by bank transfer; Algerian clients pay in DZD, excluding VAT (19 % added). The first 10 clients get 40 % off for 12 months, in exchange for a named case study.
How do I get a paid plan?
Professional and Team are ordered online on this page, at the price shown, paid by transfer to the AGB account or in cash; the proforma and the key arrive by e-mail. For API and Platform, the data licence and one-off purchases, give your company, your call volume and your countries in the form on this page: you get the priced offer by e-mail as soon as we have all your information.
Which countries are live?
Algeria, Tunisia and Morocco are live, and more African and MENA countries are coming. The free tier covers Algeria only: the data of Tunisia and Morocco needs an API key. Add the country parameter (TN or MA) to a route or a tool. The activity codes of these two countries have no status yet (free or regulated). The detail is in the Countries live section.
Does the API hold customer or personal data?
No. It serves public data only: activity codes, ANAE activities, wilayas, the Journal officiel index and tables of contents, the customs tariff, legal forms and the calculators. No UpGrowth customer or lead data is reachable from it.
Does the customs tariff give duty rates?
No. The API serves the sections and chapters of the nomenclature, without rates. For a rate, the source is the Direction générale des douanes.
Is the text of the Journal officiel available?
Yes, in French. The API and the MCP server serve the full text of the Journal officiel acts from 1962 to 2026. The free tier, through MCP and with no key, covers the current year and the 2 years before it. Older years answer a 403 key_required error and need a paid plan or the trial. The Arabic text is not available yet. The PDFs and the official titles remain the property of the Secrétariat général du Gouvernement (joradp.dz).
Is UpGrowth an official source?
No. UpGrowth is a private firm. It keeps this data up to date from official publications and speaks for no administration. The calculators give an estimate, not tax advice.
How do I connect it to Claude?
Add it from Claude's connector directory (https://claude.ai/directory/upgrowth), or as a custom connector with the address https://www.upgrowth.dz/mcp. In Claude Code, one command is enough: see the Connect section. No sign-in is needed on the free tier. For a paid plan, send your key in the Authorization header (Authorization: Bearer ugk_...).
Where does each answer come from?
Every answer of the API and the connector says which dataset it comes from, its official source with the link, its licence, the line to credit and the date of the snapshot (in meta). With the data licence for AI, every record carries its gazette, issue, page and link.
What does the free tier of the connector include?
30 calls a day per MCP session, 20 calls a day per IP address on REST, Algeria data only, the Journal officiel of the current year and the 2 years before it, 10 rows per search, free calculators, with attribution to upgrowth.dz. Our data API and MCP server are live for Algeria, Tunisia and Morocco and are expanding in Africa and the Middle East: the other two countries need a key.
What does a paid key add?
Every live country (Algeria, Tunisia, Morocco), the Journal officiel since 1962 with the French full text, full result pages and regulatory alerts.
How much is the Professional plan, and can I try it?
Professional costs $3,900 a year, or 390,000 DA excl. VAT a year, or 39,000 DA excl. VAT a month. The Professional trial lasts 14 days and includes 1,000 calls: start it with the trial form on this page.
Your price right now
Pick a plan, the number of users and the country of your company: the price shows at once.
Your price
Professional
390,000 DAexcl. VATa year
Or 39,000 DA a month.
Excluding VAT, 19 % added.
This is the price you pay. After your request, we send the proforma and the key.
Request accessRequest access
For Essentiel, Professional and Team, the price on the page is the price: fill in the form and we send the proforma and the key. For API and Platform, the data licence and one-off purchases, describe your company and your use: you get an instant quote as soon as we have the call volume, the countries and the users. The 14-day trial starts by itself with the form in the Plans section.
Algerian clients pay in DZD, excluding VAT (19 % added), by transfer to our AGB account or in cash. Foreign clients pay yearly by bank transfer.
Your company
These four answers travel with your message.
Your plan
The plan you choose travels with your message.
Choose a plan to see its price.
As soon as the form is sent, the priced offer and the proforma come in the first reply.
Leave us your number and we take it from there.
Or reach us directly
- Public data only
- Source and licence in every answer
- No cookies, open to every origin (CORS)

