Goods & Services API documentation

Goods & Services API documentation
3. Operators


Operators

DT One Goods & Services API covers many operators.

This section presents the different methods you can use to get the list of operators available on your account.

These methods return the list of operators offered on your account.

Note that an object operator is defined by an id, name, country id and country name.

{
    "operator_id": => NUMERIC,
    "operator":    => VARCHAR,
    "country_id":  => NUMERIC,
    "country":     => VARCHAR
}

1- Main list of operators

Request(s) :

GET /operators[?service_id=XXX&country_id=XXX] - To retrieve the list of all operators available on your account. This can be filtered by country and/or service, to return operators within one country, and operators that propose a specific service.

Response :

HTTP Code: 200

Body:

{
    "operators":[
        {
            "operator_id":1959,
            "operator":"Claro TV Guatemala USD",
            "country_id":756,
            "country":"Guatemala"
        },
        {
            "operator_id":1808,
            "operator":"DTH Airtel India",
            "country_id":766,
            "country":"India"
        },
        {
            "operator_id":1804,
            "operator":"DTH Dish TV India",
            "country_id":766,
            "country":"India"
        }
    ]
}

2- List of operators proposing a specific service

Request :

GET /services/{service_id}/operators - List of operators proposing a given service which can be filtered to return operators from a given country only.

Response :

HTTP Code: 200

Body:

{
    "operators":[
        {
            "operator_id":1988,
            "operator":"Indomaret VBE Indonesia",
            "country_id":767,
            "country":"Indonesia"
        }
    ]
}

3- List of operators for a given country

Request :

GET /countries/{country_id}/operators[?service_id] - List of operators for a specific country, which can be filtered to return only operators proposing a specific service.

Response :

HTTP Code: 200

Body:

{
    "operators":[
        {
            "operator_id":1808,
            "operator":"DTH Airtel India",
            "country_id":766,
            "country":"India"
        }
    ]
}

4- Return the operator of a specific MSISDN or account number

Request :

GET /services/{service_id}/operators?country_id={country_id}&account_number={account_number} - To find out the operator of the MSISDN or account number.
Currently, the feature is only available to countries with Bundles service.

Response :

HTTP Code: 200

Body:

{
    "operators":[
        {
            "operator_id":2201,
            "operator":"IDEA Uttar Pradesh East India",
            "country_id":766,
            "country":"India"
        }
    ]
}