--- title: "Get the social contributions of a country" method: GET path: "/social-contributions" tags: ["Social contributions"] --- # Get the social contributions of a country `GET /social-contributions` ## Request - Base URL: `https://www.upgrowth.dz/api/v1` - URL: `https://www.upgrowth.dz/api/v1/social-contributions` - Auth: one of: - none - HTTP bearer The 2026 social contributions, each with its base and official source: CNAS and CASNOS for Algeria, CNSS and the payroll levies (TFP, FOPROLOS) for Tunisia (country=TN), CNSS, AMO and TFP for Morocco (country=MA). ## Query parameters - `lang` 'fr' | 'ar' | 'en' - `country` string ## Response `200` The data, with its meta. - object - `data` SocialContributions, required - `currency` string, required: ISO 4217 code of the currency of the amounts: DZD for Algeria, TND for Tunisia, MAD for Morocco. - `year` integer, required: The year of the rules. - `contributions` SocialContribution[], required - `code` string, required: A short stable name for the contribution. - `name` string, required: The name of the contribution, in the language of the request. - `payer` 'employer' | 'employee' | 'employer_and_employee' | 'insured_person' | 'third_party', required: Who pays it: the employer, the employee, both, the insured person alone (a self-employed person, an artist), or a third party that pays for the insured person's activity. - `rate_percent` number, nullable: The total rate in percent, null when the contribution has a range or a flat amount instead. - `employer_percent` number, nullable: The employer share, when the rate is split. - `employee_percent` number, nullable: The employee share, when the rate is split. - `other_percent` number, nullable: Algeria: a share that is neither the employer's nor the employee's (the social works share of the CNAS), when the rate is split. - `rate_breakdown_percent` object, nullable: Algeria, CASNOS: how the rate divides between the branches of social security. - `social_insurance` number: The social insurance share of the rate. - `retirement` number: The retirement share of the rate. - `rate_range_percent` object, nullable: The lowest and the highest rate, when it depends on the activity. - `min` number: The lowest rate. - `max` number: The highest rate. - `reduced_rate_percent` number, nullable: A reduced rate, when there is one. - `base_min_dzd` number, nullable: Algeria, CASNOS: the floor of the yearly contribution base, in dinars (the yearly guaranteed minimum wage). - `base_max_dzd` number, nullable: Algeria, CASNOS: the ceiling of the yearly contribution base, in dinars (twenty times the floor). - `contribution_min_dzd` number, nullable: Algeria, CASNOS: the yearly contribution on the floor of the base, in dinars. - `contribution_max_dzd` number, nullable: Algeria, CASNOS: the yearly contribution on the ceiling of the base, in dinars. - `flat_option_dzd` number, nullable: Algeria, CASNOS: the flat yearly contribution an auto-entrepreneur may choose, in dinars. - `base_max_mad` number, nullable: Morocco, CNSS: the monthly salary ceiling of the contribution base, in dirhams, null when the base is not capped. - `base` string, nullable: What the rate is applied to. - `applies_to` string, nullable: Who or what it applies to. - `exemptions` string, nullable: Who is exempt. - `legal_basis` string, nullable: The legal text it comes from. - `note` string, nullable: A note: deadlines, penalties. - `source` SourceRef, required - `url` string, uri, required: The official page the record was read on. - `title` string, required: What the page is. - `retrieved` string, required: The day the page was read, as YYYY-MM-DD. - `sources` SourceRef[]: Other official pages the record was read on, when there are any. - `url` string, uri, required: The official page the record was read on. - `title` string, required: What the page is. - `retrieved` string, required: The day the page was read, as YYYY-MM-DD. - `meta` Meta, required - `country` string, nullable: ISO 3166-1 alpha-2 code of the country the answer is about, for example DZ. Present on every successful answer: null only for the list of countries. - `dataset` string, required: Identifier of the dataset the answer comes from. - `source` string, required: Name of the source, in the language of the request. - `source_url` string, required: The page that describes the source. - `licence` string, nullable, required: The licence of the dataset: CC BY 4.0 for the datasets UpGrowth publishes under it, otherwise null. - `licence_url` string, nullable, required: Link to the text of the licence, null when licence is null. - `attribution` string, required: The credit to give when the data is used, in the language of the request: UpGrowth, with a link to https://www.upgrowth.dz. - `updated` string, nullable, required: Day of the snapshot of the data, as YYYY-MM-DD. For the tax rates, social contributions and institutions: the day the official pages were read. - `notice` string: Datasets without an open licence only: why. A null licence never means public domain. - `help` object, required: A call to action to relay to the user, in the language of the request. - `text` string, required: One sentence to pass on to the user. - `url` string, uri, required: The contact page of UpGrowth to send the user to. - `total` integer: Number of results. Present on lists. - `limit` integer: Page size used. Paginated lists only. - `offset` integer: Results skipped. Paginated lists only. - `sommaire_years` integer[]: Journal Officiel search only: the years whose summaries are searched. - `free_years` integer[]: Calls with no key, Journal Officiel routes only: the years such a call may read. - `truncated` object: Calls with no key only: present when the answer holds fewer rows than matched, because such a call gets at most 10 rows and cannot page. - `returned` integer, required: Rows in this answer. - `total` integer, nullable: Rows that matched, null when unknown. - `free_note` string: Calls with no key only: says the list is not complete. Present with truncated. - `sources` SourceRef[]: Tunisian governorates and Moroccan regions only: every official page the list was read on. - `url` string, uri, required: The official page the record was read on. - `title` string, required: What the page is. - `retrieved` string, required: The day the page was read, as YYYY-MM-DD. - `disclaimer` Localized: The same text in the three languages of the site. - `fr` string - `ar` string - `en` string ## Other responses - `400`: A parameter is missing or invalid. error.code names the problem and error.message says how to fix it. - `401`: invalid_key: the Authorization header is malformed, or the key is unknown or revoked. A call without the header is never refused with this code, it uses the free tier. - `403`: dataset_unavailable: the account of the key may not read the data of this country. access_denied: the account is not served. Neither says why. key_required: a call with no key asked for what needs one (a country other than Algeria, an older year of the Journal Officiel, a page of a search past the first). trial_ended: the trial of the account is over. - `404`: not_found: the code, the issue or the section does not exist. country_not_available: the country is not live, or does not have this dataset yet; the message lists the live countries. - `429`: rate_limited (more than about 30 requests in 10 seconds from one address), free_quota_exceeded (the free tier of the address is used up for today), quota_exceeded (the daily quota of the key is used up) or monthly_quota_exceeded (the monthly quota of the account is used up, on the plans that have one) or trial_quota (the 1,000 calls of a trial are used up, which does not reset). Retry-After says when to try again. - `503`: unavailable: a call with a key could not be counted right now. Retry in a moment. --- [API](https://skmtc.dev/upgrowth/apis/upgrowth-algerian-business-data-api.md) · [All operations](https://skmtc.dev/upgrowth/apis/upgrowth-algerian-business-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/upgrowth/apis/upgrowth-algerian-business-data-api/revisions/76dce93244ad?raw)