Counts by provider
GET /api/rent.php?method=getCountWithProviders
Send a GET request and check status in the JSON response: 1 means success and 0 means failure, even with HTTP 200. If it fails, read msg for the reason.
Authentication
The apikey query parameter is optional. Omit it for public data; set it for account-specific data or pricing where documented.
Parameters
| Name | Location | Type | Required | Example | Description |
|---|---|---|---|---|---|
method | query | string | Yes | "getCountWithProviders" | Method name |
apikey | query | string | No | (optional) | Optional API key. When supplied, it may affect personalized rental data. |
country | query | string | Yes | "KZ" | Country code of number Countries list |
dtype | query | string | No | "week" | Type of period: week or month Defaults to week when omitted. |
dcount | query | integer | No | 1 | Count type of period, i.e. if dtype=week then counts of weeks Defaults to 1 when omitted. |
How to use this method
Compare stock by service and provider. For each service code, Amount maps provider names to counts and Total gives the combined number. Read these keys from the response: both service codes and provider names can change.
Check JSON status even with HTTP 200. If it is 0, read the error in msg.
Request examples
Environment and dependencies. Each example encodes query values and allows 30 seconds for the request. Check HTTP and JSON status before using data. cURL prints the response for you to check; Java uses Jackson to read the JSON.
# Optional: add --data-urlencode "apikey=$SMSPVA_API_KEY" for account-specific data.
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=getCountWithProviders" \
--data-urlencode "country=KZ" \
--data-urlencode "dtype=week" \
--data-urlencode "dcount=1"Responses
Check the response that matches your request. Example values and dates are illustrative. Optional fields can depend on the outcome or the response format you selected.
HTTP 200
Success
application/json
Illustrative response
{
"status": 1,
"data": {
"opt48": {
"Amount": {
"Limbo_AT": 12,
"Tele2_AT": 1,
"yesss_AT": 69
},
"Total": 82
}
}
}| Name | Type | Description |
|---|---|---|
status | integer | Status of the response: 1 for success, 0 for failure |
data | object | Service codes mapped to provider counts and totals. |
data.* | object | |
data.*.Amount | object | Provider names mapped to available number counts. |
data.*.Amount.* | integer | |
data.*.Total | integer | Total available numbers for the service. |
msg | string | Error message when status is 0. |