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.

Free tier, no sign-inREST API and MCP connectorReference data under CC BY 4.0

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.

Server URL
https://www.upgrowth.dz/mcp
Open the listing in Claude's directory

2. Claude Code: one command

Run it in your terminal.

Claude Code
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
curl https://www.upgrowth.dz/api/v1/wilayas
Open openapi.json

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.

Need a key or a trial?Describe your use: instant quote as soon as we have all your information.Request access

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
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
curl "https://www.upgrowth.dz/api/v1/activities/202407?lang=en"
JSON
{
  "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
curl "https://www.upgrowth.dz/api/v1/calculators/casnos?revenue=3000000&regime=FORFAITAIRE_ACHAT_VENTE&year=2026"

The answer envelope

Every successful answer is an object { data, meta }. meta holds dataset, source, source_url, licence, licence_url, attribution, updated and help. Lists add total, limit and offset. When a dataset has no open licence, licence is null and meta.notice says why.

The call to action to relay

meta.help is an object { text, url } in the language you asked for: a short sentence and the link to UpGrowth's contact form. An application or an assistant can relay it as it stands to its user.

Choose the language

Every route and every MCP tool accepts lang: fr, ar or en, fr by default. It sets the language of the texts in the answer: the source, the line to credit, the licence notice and the help line (meta.help).

Rate limit headers

Every successful answer carries X-RateLimit-Limit (the limit for the day), X-RateLimit-Remaining (what is left) and X-UpGrowth-Tier (free, starter, pro, business or enterprise). The limit errors (429) and the unavailable error (503) add Retry-After, in seconds. Counters reset at 00:00 UTC.

With a paid key

Send your key in the Authorization header. A malformed header is refused with a 401 error, never silently ignored.

curl
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.json

Errors

An error is an object { error: { code, message } } with the matching HTTP status. It is never cached.

  • 400invalid_parameterA parameter is invalid. The message says what to fix.
  • 401invalid_keyUnknown or revoked key, or a malformed Authorization header.
  • 404not_foundUnknown route or code.
  • 403key_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.
  • 403trial_endedThe trial of this account is over.
  • 429free_quota_exceededThe free tier limit is reached for the day.
  • 429quota_exceededThe daily limit of the key is reached.
  • 429trial_quotaThe calls of the trial are used up.
  • 429rate_limitedToo many requests in a short time: slow down.
  • 503unavailableA keyed call cannot be counted right now: retry in a moment.
  • 503data_unavailableThe data is not available right now: retry later.
JSON
{
  "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/activities

    Parameters: 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-activities

    Parameters: 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/wilayas

    Parameters: lang

    The 58 historic wilayas.

  • GET/wilayas/{code}

    Parameters: lang

    One wilaya, by its two-digit code.

  • GET/journal-officiel/years

    Parameters: lang

    The years of the Journal officiel index.

  • GET/journal-officiel/search

    Parameters: q, lang, year, limit, offset

    Search the titles in the tables of contents, with year as an option.

  • GET/journal-officiel/{year}/issues

    Parameters: 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/sections

    Parameters: lang

    The sections of the customs tariff.

  • GET/customs-tariff/sections/{section}/chapters

    Parameters: lang

    The chapters of a section, given by its Roman numeral (XVI, for example).

  • GET/creation/legal-forms

    Parameters: lang

    The legal forms: number of partners, minimum capital and State fees. No UpGrowth fee.

  • GET/calculators/casnos

    Parameters: revenue, regime, year, lang

    CASNOS 2026 contribution. regime is required: FORFAITAIRE_ACHAT_VENTE, FORFAITAIRE_PRESTATIONS, BENEFICE_REEL, AUTO_ENTREPRENEUR or PREMIERE_ANNEE.

  • GET/calculators/ifu

    Parameters: 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.

Server URL
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.

mcp.json
{
  "mcpServers": {
    "upgrowth-algeria-data": {
      "url": "https://www.upgrowth.dz/mcp"
    }
  }
}

VS Code

Add the server to the .vscode/mcp.json file of your project.

.vscode/mcp.json
{
  "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_codes

    Search CNRC activity codes by code or by words.

  • get_activity_code

    Read one CNRC activity code and its status.

  • search_anae_activities

    Search the ANAE auto-entrepreneur activities.

  • get_anae_activity

    Read one ANAE activity.

  • list_wilayas

    List the wilayas.

  • get_wilaya

    Read one wilaya by its code.

  • list_jo_years

    List the years of the Journal officiel index.

  • list_jo_issues

    List the issues of a year.

  • get_jo_issue

    Read one issue and its table of contents.

  • search_jo_titles

    Search the titles in the tables of contents.

  • customs_tariff_sections

    List the customs tariff sections.

  • customs_tariff_chapters

    List the chapters of a section.

  • creation_legal_forms

    List the legal forms, their minimum capital and the State fees.

  • calculate_casnos

    Estimate the 2026 CASNOS contribution.

  • calculate_ifu

    Estimate the 2026 IFU.

  • list_countries

    List the live countries: Algeria, Tunisia and Morocco.

  • get_tax_rates

    Read the tax rates of a country.

  • get_social_contributions

    Read the social contributions of a country.

  • list_institutions

    List the institutions of a country.

  • get_vat_regimes

    Read the VAT regimes, each with the act that establishes it.

  • get_tax_calendar

    Read the tax calendar, each deadline with its act.

  • get_support_schemes

    Read the support schemes, each with its act.

  • search_jo_text

    Search the full text of the Journal officiel acts, from 1962 to 2026.

  • get_jo_act

    Read one Journal officiel act in full text.

  • list_communes

    List the communes, with their postal code and daira.

  • get_commune

    Read one commune by its code.

  • search_post_offices

    Search the Algérie Poste post offices.

  • list_dairas

    List the dairas.

  • search_tax_code

    Search the six DGI tax codes.

  • get_tax_code_article

    Read 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.

Start the trial with the form below, or order the yearly plan onlineEssentiel, Professional and Team: the price shown is the price. Other plans: instant quote from your answers in the form.Request access

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.

Read the CC BY 4.0 licence

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:

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
Order on WhatsApp

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 trial with the form below, or order the yearly plan onlineEssentiel, Professional and Team: the price shown is the price. Other plans: instant quote from your answers in the form.Request access

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

Enter the e-mail address of your subscription: we send you a 6-digit code.

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

Essentiel, Professional and Team: the price shown is the price. Other plans: instant quote from your answers in the form.

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 access

Request 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.

Plan

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.

Get the data API

One sentence is enough, and it is required. The more we know, the more precise the quote.

Your message goes straight to our inbox.

UpGrowth (SPASU UpGrowth Connect, RC 25B1205167, Algiers) uses this information only to handle and follow up your request. Our team reads it; if our server cannot receive the form, a backup copy is emailed through services based outside Algeria (FormSubmit, Gmail). You can access, correct or erase it, or object to its use, by writing to contact@upgrowth.dz (Algerian Law 18-07 as amended by Law 25-11). Privacy policy

  • Public data only
  • Source and licence in every answer
  • No cookies, open to every origin (CORS)