CardBoardFish.com
CardBoardFish HTTPSMS - Connect directly to the CardBoardFish SMS gateway
+ Search:
+ Quick login:
  • HTTPSMS
  • Free API's in many language
  • Dedicated incoming number
  • Connect directly to our gateway
  • More...
  • Email2SMS
  • Send an email to any mobile
  • 2-way messaging
  • Send from anywhere/anytime
  • More...
  • Batch Sender
  • Send large volumes of SMS
  • No software to install
  • Upload large lists of numbers
  • More...
  • Desktop Sender
  • Quickly send SMS from your PC
  • Appears to come from your mobile
  • Message 10 recipients at once
  • More...
See pricing and services suitable for your needs:
How many text messages do you plan to send each month?
What do you use text messaging for?
How can we help you do this?
- from
Click Here to Contact Us

HTTPSMS Quick Start: A brief introduction to implementing HTTPSMS in to your own bespoke systems.

Input Parameters:

This URL should be used with the input parameters
http://sms1.cardboardfish.com:9001/HTTPSMS?

Quick Start Guide & Code Examples:

This table lists each parameter that can be submitted to the URL given above. All of these parameters are required to send an SMS. Please see the HTTPSMS Protocol Specification (PDF) for optional parameters.

Parameter Name Description Example Values
S System Type Must be set to value: H H
UN Username Account username (case sensitive) user01
P Password Account password (case sensitive) pass1
DA Destination Address Destination mobile number in international format without + prefix. Up to 10 different numbers can be supplied separated by commas. 447973123456 or 447875622322, 34610842235
SA Source Address Originator address (sender id). Up to 16 numeric or 11 alphanumeric characters. CBF or 447973123456 or 8040
M Message The SMS text for plain messages or UCS2 hex for Unicode. For binary, hex encoded 8-bit data. Please call me at the office.
ST (recommended) Source Address Type of Number (TON) Controls the type of originator where:
1=International numeric
0=National numeric
5=Aplhanumeric
See section 5.4 in the HTTPSMS Protocol Specification (PDF)
Example URL with all required parameters

Successful Response:

HTTP Header 200 OK
Content OK messageid1[ messageidn][ UR:userreference]

Error Response:

Error Response: Invalid Username
HTTP Header 401 Unauthorized
Content ERR -10
Error Response: Invalid Destination or Destination Not Covered
HTTP Header 503 Service Unavailable
Content ERR -15
Error Response: Not Enough Credit
HTTP Header 402 Payment Required
Content ERR -5
Error Response: System Error, Please Retry
HTTP Header 500 Internal Server Error
Content ERR -20
Error Response: Request Error, Do Not Retry
HTTP Header 400 Bad Request
Content ERR -25
Pay us with Paypal, Google checkout, Maestro, Delta, JCB, Mastecard, Visa, Visa Electron, American Express