SMS Exchange

What is it ?

The SMS exchange section of this API represents all the exposed APIs related to SMS buying and selling. Developers use this section to integrate rates, SDRs with third party applications.

Visit Github repository for code examples

Don't have an account? Signup here

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

Buyer SDRs

Overview
This folder contains SDR (SMS Detail Record) reporting endpoints for TCXC buyers. Use these requests to retrieve detailed information about your SMS traffic, including volumes, costs, and delivery performance per vendor or destination. The goal is to help your team monitor traffic in near real time, reconcile invoices, and debug routing or quality issues quickly.

What you can do with these endpoints

  • List SDRs for a time range – pull all records for a given date/time window for billing, fraud detection, or reconciliation.

  • Filter SDRs by vendor, buyer account, or trunk – isolate traffic for a specific partner or interconnect.

  • Filter by call attributes – e.g., Sender, Destination, country, prefix, disconnect cause, or call result (answered, failed, no‑answer, etc.).

  • Summarize performance – build dashboards around Submitted, Delivered, traffic , and cost per destination.

#List SDRs

POSThttps://apiv2.telecomsxchange.com/buyers/smshistory

This method allows you to pull SMS Detailed records from SMS exchange.

Query parameters

prefixintegeroptional

Example 44

sentintegeroptional

Example 1

date_fromdatetimeoptional

Example 2020-09-24 17:49:30

date_todatetimeoptional

Example 2017-09-24 17:49:30

Body parameters

application/x-www-form-urlencoded
showstringrequired

"good" for successfully sunmitted messages, "bad" for failed to submit.

Example good

prefixintegerrequired

optional You can specify country code (prefix) or leave empty for all

Example 44

sentintegerrequired

1 for successfull messages, 0 for failed messages

Example 1

date_fromdatetimerequired

Only show SMS messages that started on this date/time or later, given as an ISO-8601 date/time string, like YYYY-MM-DDTHH:MM:SS (for example 2018-10-05T22:45:32

Example 2015-10-18 19:19:27

date_todatetimerequired

Only show SMS messages that ended on this date/time or earlier, given as an ISO-8601 date/time string, like YYYY-MM-DDTHH:MM:SS (for example 2018-10-06T02:10:03)

Example 2020-10-24 17:49:30

curl --digest \
  -u "$TCXC_USERNAME:$TCXC_API_KEY" \
  -X POST \
  "https://apiv2.telecomsxchange.com/buyers/smshistory" \
  -d "show=good" \
  -d "prefix=44" \
  -d "sent=1" \
  -d "date_from=2015-10-18 19:19:27" \
  -d "date_to=2020-10-24 17:49:30"
SMS detail records3 results
TimeMessageRouteStatusCost
2019-11-03 · 15:47:1212262403276 → 22961175098 BENIN · Mobile - MTNNobelGlobesent$0.0137
2019-11-03 · 15:45:4312262403276 → 22501251280 IVORY COAST · Mobile - MoovNobelGlobesent$0.0230
2019-11-03 · 15:45:3112262403276 → 22501159632 IVORY COAST · Mobile - MoovNobelGlobesent$0.0230
Rendered from the example response.

Market View (SMS)

Lookup Market Rates in real time for SMS wholesale terminaiton from several sellers. the returned results include (prefix, rates, asr, acd, ratings, reviews and seller payouts and more)

Warning!

The lookup API allows you to compare prices for certain destinations and it is not intended to fetch too many results. therefore you may experience slowness when fetching too many rates using this API. If you're looking to sync high count of rates records at once, we would recommend you to use carrier download rates API feature.

#Search Market View (SMS)

POSThttps://apiv2.telecomsxchange.com/marketview/search

Search Market View for SMS termination rates.

Body parameters

application/x-www-form-urlencoded
prefixintegerrequired

Country Code

Example 447

searchformintegerrequired

*Required

Example 1

smppintegerrequired

*Required to filter SMS termination rates only

Example 1

pagerintegerrequired

*Required for pagination

Example 5

offintegerrequired

*Required offset value (must be less than pager value)

Example 0

curl --digest \
  -u "$TCXC_USERNAME:$TCXC_API_KEY" \
  -X POST \
  "https://apiv2.telecomsxchange.com/marketview/search" \
  -d "prefix=447" \
  -d "searchform=1" \
  -d "smpp=1" \
  -d "pager=5" \
  -d "off=0"
Rates for prefix 4471063 sellers
SellerPer SMSASRACDMsg / wk
MIMittoPremium$0.02040.0%–0
MIMittoPremium$0.02040.0%–0
MIMittoPremium$0.06000.0%–0

Lowest price highlighted. Live data adds ratings, reviews and capacity per seller.

Rendered from the example response.

#Top SMS Destinations

GEThttps://apiv2.telecomsxchange.com/buyers/toproutes

This API endpoint allows memvers to retreive a list of the top (5, 10, 20) destinations with SMS traffic for a specific period of time (today, yesterday, week, month) and specific route type such as TDM , CLI , NCLI, NA.

Query parameters

periodstringrequired

period: supported values are today, yesterday, week, month

Example week

smppintegerrequired

Required value for SMS

Example 1

numberintegerrequired

Expects integer values from 1 to 20 and defaults to 5 if not set.

Example 10

curl --digest \
  -u "$TCXC_USERNAME:$TCXC_API_KEY" \
  "https://apiv2.telecomsxchange.com/buyers/toproutes?period=week&smpp=1&number=10"
Top destinationsby traffic
  1. 1SPAINMobile - Vodafone, Mobile - Orange, Mobile - Movistarfrom $0.0255per SMS
  2. 2SAUDI ARABIAMobile - Al Jawal, Mobile - Al Jawal, Mobile - Mobilyfrom $0.0133per SMS
  3. 3AUSTRALIAMobile - Vodafonefrom $0.0161per SMS
  4. 4NIGERIAMobile - 9mobile, Mobile - 9mobilefrom $0.0090per SMS
  5. 5KUWAITMobile - VIVAfrom $0.0780per SMS
  6. 6CHILEMobile - Clarofrom $0.0196per SMS
  7. 7ECUADORMobile - Movistarfrom $0.0738per SMS
Rendered from the example response.