Account
Balance
Use this endpoint to query your current balance. No further parameters are required for the query. The return is a simple text with your current balance as a float number with a dot as a separator for the decimal places.
Request
curl -G https://gateway.seven.io/api/balance \
-H "X-Api-Key: YOUR_API_KEY"
Answer
290.67
Prices
You can use this endpoint to retrieve the current prices of your account for sending SMS.
Parameter
- Name
country- Type
- string
- Description
Country Code according to ISO-3166 (ALPHA-2) for which you want to query the prices. If this parameter is not specified, the prices of all countries are displayed.
- Name
format- Type
- json|csv
- Description
By default, the data is returned as JSON. However, you can also request a CSV format. To do this, use the parameter format=csv
Request
curl -G https://gateway.seven.io/api/pricing \
-H "X-Api-Key: YOUR_API_KEY"
Response
{
"countCountries": 1,
"countNetworks": 4,
"countries": [
{
"countryCode": "AT",
"countryName": "Austria",
"countryPrefix": "43",
"networks": [
{
"mcc": "232",
"mncs": [
"02"
],
"networkName": "A1 Telekom Austria",
"price": 0.075,
"features": [],
"comment": ""
},
{
"mcc": "232",
"mncs": [
"01"
],
"networkName": "A1 Telekom Austria (A1.net)",
"price": 0.075,
"features": [
"alpha",
"numeric",
"dlr",
"sc"
],
"comment": ""
},
{
"mcc": "232",
"mncs": [
"11"
],
"networkName": "A1 Telekom Austria (bob)",
"price": 0.075,
"features": [],
"comment": ""
},
{
"mcc": "232",
"mncs": [
"09"
],
"networkName": "A1 Telekom Austria (Tele2Mobil)",
"price": 0.075,
"features": [],
"comment": ""
}
]
}
]
}
Request
curl -G https://gateway.seven.io/api/pricing?format=csv \
-H "X-Api-Key: YOUR_API_KEY"
Response
"countryCode"; "countryName"; "countryPrefix"; "mcc"; "mncs"; "networkName"; "price"; "features"; "comment"
"AT";"Austria";"43";"232";"02";"A1 Telekom Austria";"0.075";"";""
"AT";"Austria";"43";"232";"01";"A1 Telekom Austria (A1.net)";"0.075";"alpha,numeric,dlr,sc";""
"AT"; "Austria"; "43"; "232"; "11"; "A1 Telekom Austria (bob)"; "0.075";"";""
"AT"; "Austria"; "43"; "232"; "09"; "A1 Telekom Austria (Tele2Mobil)"; "0.075";"";""
"AT"; "Austria"; "43"; "232"; "12"; "A1 Telekom Austria (yesss!)"; "0.075";"";""
"AT";"Austria";"43";"232";"92";"ArgoNET GmbH (ArgoNET)";"0.075";"";""
"AT";"Austria";"43";"232";"14,16,19";"Hutchison Drei Austria";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"05,10";"Hutchison Drei Austria (3)";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"08";"Lycamobile Austria (Lycamobile)";"0.075";"";""
"AT";"Austria";"43";"232";"17";"MASS Response Service GmbH";"0.075";"alpha,numeric,dlr,sc";""
"AT"; "Austria"; "43"; "232"; "20"; "MTEL Austrija GmbH (m:tel)"; "0.075";"";""
"AT"; "Austria"; "43"; "232"; "15"; "Mundio Mobile Austria (Vectone Mobile)"; "0.075";"";""
"AT"; "Austria"; "43"; "232"; "91"; "ÖBB (GSM-R A)"; "0.075";"";""
"AT"; "Austria"; "43"; "232"; "06"; "Orange Austria GmbH (Orange AT)"; "0.075";"";""
"AT";"Austria";"43";"232";"22";"Plintron Austria Limited";"0.075";"";""
"AT"; "Austria"; "43"; "232"; "21"; "Salzburg AG für Energie, Verkehr und Telekommunikation"; "0.075";"";""
"AT";"Austria";"43";"232";"18";"smartspace GmbH";"0.075";"";""
"AT";"Austria";"43";"232";"03,13";"T-Mobile Austria (T-Mobile AT)";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"07";"T-Mobile Austria (tele.ring)";"0.075";"";""
"AT";"Austria";"43";"232";"23";"T-Mobile Austria GmbH";"0.075";"";""
"AT"; "Austria"; "43"; "232"; "04"; "T-Mobile Austria GmbH (T-Mobile AT)"; "0.075";"";""
Statistics
Retrieve detailed statistics of your account directly via our API.
Parameters
- Name
start- Type
- date
- Description
Start date of the statistics in the format YYYY-MM-DD. The date from 30 days ago is set by default.
- Name
end- Type
- date
- Description
End date of the statistics. The current day by default.
- Name
label- Type
- all|string
- Description
Only shows data for a specific label.
- Name
subaccounts- Type
- only_main|all|integer
- Description
Receive data only for the main account, for all your (sub)accounts or only for specific subaccounts
ID of a subaccount - Displays the data of a specific subaccount. all - Displays the data of all accounts and subaccounts cumulatively. only_main - Displays only the data of the main account.
- Name
group_by- Type
- date|label|subaccount|country
- Description
Defines the grouping of the data. Default is date
Request
curl -G https://gateway.seven.io/api/analytics \
-H "X-Api-Key: YOUR_API_KEY"
Response
[
{
"date": "2024-03-27",
"sms": 200,
"rcs": 6729,
"voice": 425,
"hlr": 5920,
"mnp": 49,
"inbound": 0,
"usage_eur": 932.12
},
{
"date": "2024-03-27",
"sms": 156,
"rcs": 5993,
"voice": 400,
"hlr": 2002,
"mnp": 0,
"inbound": 48,
"usage_eur": 854.39
},
// ...
]