Account

GET/api/balance

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

GET
/api/balance
curl -G https://gateway.seven.io/api/balance \
  -H "X-Api-Key: YOUR_API_KEY"

Answer

290.67

GET/api/prices

Prices

You can use this endpoint to retrieve the current prices of your account for sending SMS.

Parameter

  • Name
    country
    Type
    string
    Description

    Code of the country 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

GET
/api/balance
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": ""
                }
            ]
        }
    ]
}

Answer

"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";"";""

GET/api/analytics

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

GET
/api/analytics
curl -G https://gateway.seven.io/api/analytics \
  -H "X-Api-Key: YOUR_API_KEY"

Response

[
  {
      "date": "2020-05-13",
      "hlr": 0,
      "inbound": 72,
      "mnp": 0,
      "sms": 145,
      "usage_eur": 0.208,
      "voice": 0
  },
  {
      "date": "2020-05-14",
      "hlr": 0,
      "inbound": 72,
      "mnp": 0,
      "sms": 1,
      "usage_eur": 0.508,
      "voice": 0
  }
  // ...
]