BSG utilizes HTTP cookies (and similar or complementary technologies) to 1) make this website safe, functional, and accessible (through the use of mandatory cookies) and 2) understand how you use our website (through the use of optional cookies) in order to improve your experience and to provide you with personalized content.

The information in the cookie text files may be related to your personal preferences or your device and is intended to make the site operate according to your expectations. The information contained in cookies does not usually identify your identity directly but is helpful in providing you with a more personalized user experience.

In accordance with the requirements of the General Data Protection Regulation (GDPR) privacy and security law that governs how the personal data of individuals in the EU may be processed and transferred, we provide you the possibility to prohibit the use of certain types of cookies when you use our website.

Read our Cookie Notice and the Privacy Policy for detailed information on how BGS collects and uses cookies. Please note that prohibiting the use of certain types of cookies may affect your interaction with the website and limit the accessibility of services we offer you. Choose the appropriate category below to learn more and to disable cookies.

Accept All cookies*
*Recommended for comfortable use of the site
Accept only necessary cookies
Accept only selected cookies
Necessary cookies
Social media
Analytics
Marketing
Developer Docs
Number Intelligence

Get general information about the RCS campaign

Method : GET

Endpoint : /api/campaigns/{id}

Description : A method to get general information about an RCS campaign.

Query string parameter

Parameter Mandatory Type Description.
id Yes integer campaign id received in response to the request:
POST /api/campaigns/rcs/send
POST /api/messages/rcs/send
POST /api/campaigns/rcs/send-groups

Answer elements

Parameter Type Description.
id integer campaign id.
name string The name of the campaign. Example: “RCS api campaign / {yyyyy-mm-dd hh:mm:ss}”, where yyyy-mm-dd hh:mm:ss is the date and time of the campaign creation.
sender string Name of the agent.
status string The current status of the campaign. Possible values: creation – the campaign has been created;
spam – the campaign has not been moderated; scheduled – the campaign is scheduled; sending – the campaign has started sending messages; paused – the campaign is paused (no messages are sent); stopped – the campaign is stopped (final status); done – the campaign is complete (final status).
message_type string Type of messages in the campaign. Possible values: sms, rcs
start_at string Campaign start date and time in the format: yyyy-mm-dd hh:mm:ss
real_start_at string Actual date and time of the campaign start in the format: yyyy- mm- dd hh:mm:ss
finished_at null|strin g Campaign end date in the format: yyyy-mm-dd hh:mm:ss
created_at string Date and time of campaign creation in the format: yyyy-mm-dd hh:mm:ss.
statistics array Array of Campaign Statistics Objects.
statistics[]delivered integer The total number of messages delivered to end users as part of a status campaign: DELIVERED READ
statistics[]sent integer Total number of messages sent as part of the campaign in statuses: DELIVERED SENT ACCEPTED SENDING UNDELIVERED FAILED EXPIRED UNKNOWN
calculated_price float Preliminary cost of the campaign.
alternative_channels object An object containing information about campaign messages that were sent via an alternative channel.
alternative_channels[]sms object The object specifies the channel for alternative message sending within the campaign.
alternative_channels[]sms[]sta tistics object An object of statistics of messages sent via an alternative channel.
alternative_channels[]sms[]sta tistics[]sent integer Total number of messages sent as part of the campaign in statuses: DELIVERED
SENT ACCEPTED SENDING UNDELIVERED FAILED EXPIRED UNKNOWN
alternative_channels[]sms[]sta tistics[]delivered integer Total number of messages delivered as part of the campaign in statuses: DELIVERED READ

An example of an answer

If the request is successfully executed:


{
   "data":[
      {
         "id":1,
         "name":"string",
         "sender":"string",
         "status":"creation",
         "message_type":"rcs",
         "start_at":"2021-04-27 19:44:06",
         "real_start_at":"2021-04-27 19:44:06",
         "finished_at":"2021-04-27 19:44:06",
         "created_at":"2021-04-27 19:44:06",
         "statistics":{
            "delivered":0,
            "sent":0
         },
         "calculated_price":123.4,
         "alternative_channels":{
            "sms":{
               "statistic":{
                  "delivered":0,
                  "sent":0
               }
            }
         }
      }
   ]
}

Interested in a special offer?

Ready to reach further?
Let’s talk

I agree to BSG privacy policy
Submit

Useful Materials

What Is Number Verifier — And Why It’s More Than Just an “HLR Lookup”

30% of SMS fail — not because of content, but numbers. Verify before you send.

10 Awesome Back-to-School Marketing Ideas 2025

The start of the school year: when parents trade in their summer margaritas for the

What Is CPaaS? Communications Platform as a Service

Talking to customers these days is more than just emails or phone calls. Businesses need