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.
إجماليات الميزانية
استرجاع أرقام الميزانية الإجمالية بما في ذلك النفقات والموارد لجميع السنوات، وتغطية الميزانية الرئيسية والميزانيات التكميلية.
GET
/budget/api/totals/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية حسب السنة المحددة
include_complementaryboolean
تضمين الميزانيات التكميلية
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
yearinteger
سنة الميزانية
total_expensesnumber
إجمالي النفقات
total_resourcesnumber
إجمالي الموارد
balancenumber
رصيد الميزانية
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/totals/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/totals/?year=2024&limit=10" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/totals/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/totals/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/totals/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
فئات الميزانية
استرجاع بيانات الميزانية المنظمة حسب الفئات، بما في ذلك النفقات والموارد.
GET
/budget/api/budget-categories/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية حسب سنة الميزانية
typestring
تصفية حسب النوع: 'نفقة' أو 'مورد'
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
categorystring
اسم الفئة
expensesnumber
إجمالي النفقات في الفئة
resourcesnumber
إجمالي الموارد في الفئة
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/budget-categories/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/budget-categories/?year=2024&limit=10" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/budget-categories/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/budget-categories/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/budget-categories/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
النفقات
استرجاع نفقات الميزانية مع هيكل هرمي اختياري. تتيح لك هذه النقطة استكشاف بيانات النفقات على مستويات مختلفة من التفاصيل.
GET
/budget/api/expenses/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية النفقات حسب سنة الميزانية
hierarchyboolean
إرجاع الهيكل الهرمي إذا كان صحيحًا
organizationinteger
تصفية حسب معرف المنظمة
limitinteger
عدد النتائج المطلوب إرجاعها لكل صفحة
offsetinteger
الفهرس الأولي الذي يتم منه إرجاع النتائج
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
idinteger
معرف سجل النفقة
yearinteger
سنة الميزانية
amountnumber
مبلغ النفقة
categorystring
فئة النفقة
organizationobject
تفاصيل المنظمة المرتبطة
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/expenses/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/expenses/?year=2024&limit=10" \
-H "Accept: application/json"
Example Response
Copy
[
{
"id": 1,
"year": 2024,
"amount": 150000.00,
"category": "Personnel",
"organization": {
"id": 1,
"name": "Department of Finance"
}
}
]
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/expenses/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/expenses/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/expenses/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
الموارد
استرجاع موارد الميزانية مع هيكل هرمي اختياري. تمثل الموارد الإيرادات ومصادر التمويل.
GET
/budget/api/resources/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية الموارد حسب سنة الميزانية
hierarchyboolean
إرجاع الهيكل الهرمي إذا كان صحيحًا
limitinteger
عدد النتائج المطلوب إرجاعها لكل صفحة
offsetinteger
الفهرس الأولي الذي يتم منه إرجاع النتائج
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
idinteger
معرف سجل المورد
yearinteger
سنة الميزانية
amountnumber
مبلغ المورد
sourcestring
مصدر أو نوع المورد
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/resources/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/resources/?year=2024&limit=10" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/resources/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/resources/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/resources/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
قائمة المنظمات
استرجاع قائمة المنظمات مع تفاصيلها بما في ذلك الاسم والرمز ومعلومات الميزانية المرتبطة.
GET
/budget/api/organization/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية المنظمات حسب سنة الميزانية
limitinteger
عدد النتائج المطلوب إرجاعها لكل صفحة
offsetinteger
الفهرس الأولي الذي يتم منه إرجاع النتائج
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
idinteger
معرف فريد للمنظمة
namestring
اسم المنظمة
codestring
رمز المنظمة
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/organization/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/organization/?year=2024&limit=10" \
-H "Accept: application/json"
Example Response
Copy
[
{
"id": 1,
"name": "Department of Finance",
"code": "FIN001"
}
]
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/organization/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/organization/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/organization/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
إحصائيات المنظمات
استرجاع المعلومات الإحصائية والبيانات المجمعة للمنظمات.
GET
/budget/api/organization/stats/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية الإحصائيات حسب سنة الميزانية
organization_idinteger
تصفية حسب معرف منظمة محدد
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
organization_idinteger
معرف المنظمة
total_expensesnumber
إجمالي مبلغ النفقات
total_resourcesnumber
إجمالي مبلغ الموارد
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/organization/stats/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/organization/stats/?year=2024&limit=10" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/organization/stats/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/organization/stats/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/organization/stats/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
الديون
استرجاع معلومات الديون حسب المصدر والسنة.
GET
/budget/api/debt/
Parameters
Parameter
النوع
الوصف
yearinteger
تصفية بيانات الديون حسب السنة
parentstring
تصفية حسب مصدر الدين الأصلي (استخدم 'null' لمصادر المستوى الأعلى)
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
yearinteger
سنة سجل الدين
debt_originobject
معلومات مصدر الدين (المعرف، الأصل، الاسم)
valuenumber
قيمة الدين بالمليون دينار تونسي
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/debt/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/debt/?year=2024&limit=10" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/debt/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/debt/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/debt/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
الدين المستحق
استرجاع معلومات الدين المستحق - المبلغ الإجمالي من المال الذي لا يزال مستحقًا ولم يتم سداده بعد، بما في ذلك المبلغ الأصلي المتبقي والفوائد المتراكمة والرسوم المرتبطة.
GET
/budget/api/outstanding-debt/
Parameters
Parameter
النوع
الوصف
yearinteger or 'last'
تصفية حسب السنة أو استخدم 'last' لأحدث سنة
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
yearinteger
سنة سجل الدين المستحق
outstanding_debtnumber
المبلغ الإجمالي للدين المستحق بالمليون دينار تونسي (المبلغ الأصلي المتبقي والفوائد والرسوم)
gdpnumber
الناتج المحلي الإجمالي بالمليون دينار تونسي
valuenumber
الدين المستحق كنسبة مئوية من الناتج المحلي الإجمالي
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/outstanding-debt/" \
-H "Accept: application/json"
With Parameters
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/outstanding-debt/?year=2024&limit=10" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/outstanding-debt/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
With Parameters
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/outstanding-debt/"
params = {"year": 2024, "limit": 10}
headers = {"Accept": "application/json"}
response = requests.get(url, params=params, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/outstanding-debt/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));
العجز
استرجاع معلومات العجز في الميزانية بما في ذلك القيم المطلقة والنسبة المئوية بالنسبة للناتج المحلي الإجمالي.
GET
/budget/api/deficit/
Response
The response body is JSON formatted with the following structure:
Field
النوع
الوصف
yearinteger
سنة الميزانية
valuenumber
القيمة المطلقة للعجز بالمليون دينار تونسي
percentnumber
العجز كنسبة مئوية من الناتج المحلي الإجمالي
gdpnumber
الناتج المحلي الإجمالي بالمليون دينار تونسي
CURL
PYTHON
NODE.JS
Example Request
Copy
curl -X GET "https://budgetv3.marsad.tn/budget/api/deficit/" \
-H "Accept: application/json"
Example Request
Copy
import requests
url = "https://budgetv3.marsad.tn/budget/api/deficit/"
headers = {"Accept": "application/json"}
response = requests.get(url, headers=headers)
print(response.json())
Example Request
Copy
const fetch = require('node-fetch');
const url = "https://budgetv3.marsad.tn/budget/api/deficit/";
fetch(url, {
headers: {
'Accept': 'application/json'
}
})
.then(response => response.json())
.then(data => console.log(data));