Reports

Base URLhttps://apiv2.telecomsxchange.com
AuthenticationHTTP Digest

Buyers

#Voice Summary Report

POSThttps://apiv2.telecomsxchange.com/buyers/voice/summary

Body parameters

application/x-www-form-urlencoded
date_fromdatetimerequired

Start of the range, inclusive. Format YYYY-MM-DD HH:MM:SS.

Example 2026-08-01 00:00:00

date_todatetimerequired

End of the range, inclusive. Use 23:59:59 to get the whole final day.

Example 2026-10-31 00:00:00

time_formatstringrequired

daily splits the range into one row per day. Any other value gives one row per calendar month.

Example monthly

statusstringrequired

good reads answered calls. bad reads failed calls. Any other value, such as all, reads both.

Example all

i_vendorintegeroptional

Example 299

i_connectionintegeroptional

integer connection ids, default all purchased routes

Example 653

accounts[]integeroptional

Your buyer account ids, repeated once per account. Omit the key entirely to cover all your voice accounts.

Example 1855

destination_descriptions[]stringoptional

Country and description joined by a hyphen, repeated once per destination. Omit to cover all destinations.

Example EGYPT - Mobile - Vodafone

downloadintegeroptional

0 returns JSON. 1 returns a CSV attachment instead.

Example 0

curl --digest \
  -u "$TCXC_USERNAME:$TCXC_API_KEY" \
  -X POST \
  "https://apiv2.telecomsxchange.com/buyers/voice/summary" \
  -d "date_from=2026-08-01 00:00:00" \
  -d "date_to=2026-10-31 00:00:00" \
  -d "time_format=monthly" \
  -d "status=all"
Voice summary2026-10-01 to 2026-10-31
Spend$0.002026 Oct
Minutes0
Calls0
Avg cost / min$0.0000
2026 Aug
$67.25
2026 Sep
$327.73
2026 Oct
$0.00
Rendered from the example response.

#SMS Summary Report

POSThttps://apiv2.telecomsxchange.com/buyers/sms/summary

Body parameters

application/x-www-form-urlencoded
date_fromdatetimerequired

Start of the range, inclusive. Format YYYY-MM-DD HH:MM:SS.

Example 2021-08-01 00:00:00

date_todatetimerequired

End of the range, inclusive. Use 23:59:59 to get the whole final day.

Example 2026-09-31 23:59:59

time_formatstringrequired

daily splits the range into one row per day. Any other value gives one row per calendar month.

Example monthly

statusstringrequired

good reads submitted messages. bad reads failed messages. Any other value, such as all, reads both.

Example all

i_vendorintegeroptional

Example 436

i_connectionintegeroptional

integer connection ids, default all purchased routes

Example 1160

accounts[]integeroptional

Your buyer account ids, repeated once per account. Omit the key entirely to cover all your voice accounts.

Example 1855

destination_descriptions[]stringoptional

Country and description joined by a hyphen, repeated once per destination. Omit to cover all destinations.

Example Oman

downloadintegeroptional

0 returns JSON. 1 returns a CSV attachment instead.

Example 0

curl --digest \
  -u "$TCXC_USERNAME:$TCXC_API_KEY" \
  -X POST \
  "https://apiv2.telecomsxchange.com/buyers/sms/summary" \
  -d "date_from=2021-08-01 00:00:00" \
  -d "date_to=2026-09-31 23:59:59" \
  -d "time_format=monthly" \
  -d "status=all"
SMS summary2021-10-01 to 2021-10-31
Spend$0.052021 Oct
Messages2
Avg cost / SMS$0.0226
2021 Aug
$3.36
2021 Sep
$1.89
2021 Oct
$0.05
Rendered from the example response.