Répartition de la dette

Getting Started

The Budget API provides programmatic access to public budget data. All endpoints return JSON-formatted responses and support various query parameters for filtering and pagination.

Response Format

All responses are returned in JSON format with appropriate HTTP status codes.

Currently, this API does not require authentication for public data access. All endpoints are publicly accessible.

Note

Rate limiting may apply to prevent abuse. Please contact us if you need higher rate limits for your application.

Totaux du Budget

Récupérer les chiffres totaux du budget, y compris les dépenses et les ressources pour toutes les années, couvrant à la fois le budget principal et les budgets complémentaires.

GET /budget/api/totals/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer par année spécifique
`include_complementary`	boolean	Inclure les budgets complémentaires

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`year`	integer	Année budgétaire
`total_expenses`	number	Total des dépenses
`total_resources`	number	Total des ressources
`balance`	number	Solde budgétaire

Catégories Budgétaires

Récupérer les données budgétaires organisées par catégories, y compris les dépenses et les ressources.

GET /budget/api/budget-categories/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer par année budgétaire
`type`	string	Filtrer par type : 'dépense' ou 'ressource'

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`category`	string	Nom de la catégorie
`expenses`	number	Total des dépenses dans la catégorie
`resources`	number	Total des ressources dans la catégorie

Dépenses

Récupérer les dépenses budgétaires avec une structure hiérarchique optionnelle. Ce point de terminaison vous permet d'explorer les données de dépenses à différents niveaux de détail.

GET /budget/api/expenses/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer les dépenses par année budgétaire
`hierarchy`	boolean	Retourner la structure hiérarchique si vrai
`organization`	integer	Filtrer par ID d'organisation
`limit`	integer	Nombre de résultats à retourner par page
`offset`	integer	L'index initial à partir duquel retourner les résultats

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`id`	integer	Identifiant de l'enregistrement de dépense
`year`	integer	Année budgétaire
`amount`	number	Montant de la dépense
`category`	string	Catégorie de dépense
`organization`	object	Détails de l'organisation associée

Ressources

Récupérer les ressources budgétaires avec une structure hiérarchique optionnelle. Les ressources représentent les revenus et les sources de financement.

GET /budget/api/resources/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer les ressources par année budgétaire
`hierarchy`	boolean	Retourner la structure hiérarchique si vrai
`limit`	integer	Nombre de résultats à retourner par page
`offset`	integer	L'index initial à partir duquel retourner les résultats

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`id`	integer	Identifiant de l'enregistrement de ressource
`year`	integer	Année budgétaire
`amount`	number	Montant de la ressource
`source`	string	Source ou type de ressource

Liste des Organisations

Récupérer une liste d'organisations avec leurs détails, y compris le nom, le code et les informations budgétaires associées.

GET /budget/api/organization/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer les organisations par année budgétaire
`limit`	integer	Nombre de résultats à retourner par page
`offset`	integer	L'index initial à partir duquel retourner les résultats

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`id`	integer	Identifiant unique pour l'organisation
`name`	string	Nom de l'organisation
`code`	string	Code d'organisation

Statistiques des Organisations

Récupérer les informations statistiques et les données agrégées pour les organisations.

GET /budget/api/organization/stats/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer les statistiques par année budgétaire
`organization_id`	integer	Filtrer par ID d'organisation spécifique

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`organization_id`	integer	Identifiant d'organisation
`total_expenses`	number	Montant total des dépenses
`total_resources`	number	Montant total des ressources

Dette

Récupérer les informations sur la dette par origine et année.

GET /budget/api/debt/

Parameters

Parameter	Type	Description
`year`	integer	Filtrer les données de dette par année
`parent`	string	Filtrer par origine de dette parent (utiliser 'null' pour les origines de premier niveau)

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`year`	integer	Année de l'enregistrement de la dette
`debt_origin`	object	Informations sur l'origine de la dette (id, parent, nom)
`value`	number	Valeur de la dette en MDT (Million de Dinars Tunisiens)

Dette en Cours

Récupérer les informations sur la dette en cours - le montant total d'argent encore dû qui n'a pas encore été remboursé, y compris le principal restant, les intérêts accumulés et les frais associés.

GET /budget/api/outstanding-debt/

Parameters

Parameter	Type	Description
`year`	integer or 'last'	Filtrer par année ou utiliser 'last' pour l'année la plus récente

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`year`	integer	Année de l'enregistrement de la dette en cours
`outstanding_debt`	number	Montant total de la dette en cours en MDT (principal restant, intérêts et frais)
`gdp`	number	PIB en MDT
`value`	number	Dette en cours en pourcentage du PIB

Déficit

Récupérer les informations sur le déficit budgétaire, y compris les valeurs absolues et le pourcentage par rapport au PIB.

GET /budget/api/deficit/

Response

The response body is JSON formatted with the following structure:

Field	Type	Description
`year`	integer	Année budgétaire
`value`	number	Valeur absolue du déficit en MDT
`percent`	number	Déficit en pourcentage du PIB
`gdp`	number	PIB en MDT