TSG Global API Documentation
  • Get Started
  • ISO/IEC/SOC Certification
  • Staging Environment Access
  • API Reference
    • Programmable SMS
      • Send an SMS Message
      • Receive an SMS Message
      • Delivery Receipts (DLRs)
      • SMPP
        • Headers
        • Errors
    • Programmable MMS
      • Send an MMS Message
      • Receive an MMS Message
      • Receive DLRs
      • SMTP
    • Phone Numbers
      • Search For New Available Numbers
      • Add Number to Cart
      • Get Reserved Numbers In Cart
      • Remove Reserved Number From Cart
      • Checkout Numbers in Cart
      • Disconnect Number
      • Get Number Information
      • Manage Number for SMS & 10DLC
        • Enable SMS/10DLC on a Number
        • Disable SMS on a Number
        • Update inbound SMS webhook/URI
      • Manage Number for MMS
        • Enable MMS on a Number
        • Disable MMS on a Number
        • Update inbound MMS webhook/URI
      • Manage Number for Voice
        • List Destination Priority
        • Add Destination Priority
        • Update Destination Priority
        • Delete Destination Priority
      • Protect your phone number
        • TextProtect Webhook
      • Toll-free phone numbers - search & ordering
    • Data Services
      • CNAM Lookup
      • Lookup SMS Carrier
    • Reports
      • CDR Records
        • Get Count of CDR Records
        • Get CDR Records
    • Compliance & Identity
      • Business Identity & 10DLC (TNID v1)
      • Toll-Free Verified Sender (Order)
      • Short Code Submission (Order)
  • GraphQL API & Authentication
Powered by GitBook
On this page
  • Status Codes
  • Error Types

Was this helpful?

  1. API Reference
  2. Programmable SMS
  3. SMPP

Errors

We use HTTP response codes to indicate specific error classes (2xx range is success, 4xx failed based on the provided parameters, 5xx are server errors). Each error has a machine readable id, and a human readable explanation. Authentication is done by passing the API key via the Authorization header.

Status Codes

Code
Description

200

The request was a success.

401

Request failed because user is not authenticated.

403

Request failed because user does not have authorization to access a specific resource.

404

Resource doesn’t exist.

409

The request conflicts with another request.

422

Your request was understood, but contained invalid parameters.

500

Something went wrong on the server, check status site and/or report the issue.

503

Service is temporarily unavailable. Generally this is temporary and the requests should be retried.

Error Types

Type
Description

unauthenticated

Request failed because the user is authenticated.

unauthorized

User does not have access to the specified resource.

not_found

Resource was not found.

server_error

Internal server error.

invalid_params

Parameters were not valid.

PreviousHeadersNextProgrammable MMS

Last updated 2 years ago

Was this helpful?