Retrieve offer information

This GET operation retrieves the details of an offer that was sent to a subscriber. If successful, you receive an HTTP response code of 200 and a JSON response containing the offer information such as the ID, the status, and the campaign of which it is a part.

See HTTP response codes for other response codes.
If you want to get all offers that were ever sent to the subscriber, omit the <offerId> in the URL. In this case, you receive an array of offers as shown in the JSON response.

GET /rte/marketplace/subscribers/<msisdn>/offers/<offerId>

accept: application/JSON

authorisation: HTTP Basic Auth

URL parameters

There are two URL parameters.

Parameter Type Description

msisdn

string

The subscriber’s MSISDN in international format.

offerId

string

An optional parameter that specifies the external offer ID used to identify a specific offer instance.


JSON response

The JSON response includes the offer information.

See RTEM data type descriptions for more information. 
{
    "offerId" : "Travel7days",
    "status" : "ISSUED",
    "offerExpiryDate" : "30/03/2020 13:34:26",
    "campaignName" : "TravelInsuranceCampaign1"
}

JSON response for all offers

{
    "offers": [
        {
            "offerId" : "Travel7days",
            "status" : "ISSUED",
            "offerExpiryDate" : "30/03/2020 13:34:26",
            "campaignName" : "TravelInsuranceCampaign1"
        },
        {
            "offerId" : "Great1Day",
            "status" : "REJECTED",
            "offerExpiryDate" : "28/03/2020 16:39:51",
            "campaignName" : "TravelInsuranceCampaignOriginal"
        }
    ]
}

RTE Marketplace JSON data type descriptions

Field Type Description

offerId

string

The external offer ID used to identify a specific offer instance.

status

string

The current status of the offer.

possible values

  • ISSUED

  • ACKNOWLEDGED

  • ACCEPTED

  • REJECTED

  • CANCELLED

  • EXPIRED

offerExpiryDate

string

The offer expiry timestamp after which the offer is no longer valid. In other words, the offer must be accepted or rejected before this date and time. Format: DD/MM/YYYY HH:MM:SS.

This field is only present when the status is ISSUED or ACKNOWLEDGED.

offerSuspensionDate

string

Indicates that the offer will not be sent to the subscriber again until after this offerSuspensionDate. Format: DD/MM/YYYY HH:MM:SS.

This field is only present when the status is ACCEPTED or REJECTED.

campaignName

string

The name of the campaign of which the offer is apart.

clientId

string

An arbitrary string used to identify the client.

channel

string

Identifies the channel through which the offer was consumed such as Web, App, or SMS.

metadata

string

Optional data to include with the request.

This data is logged for audit and reporting purposes.

notifications

array

An optional array containing messages to the subscriber.

productExpiryDate

string

An optional expiry date for the offer expressed in DD-MM-YYYY format.

This is only relevant for the Accept an Offer request.

HTTP response codes

Code Description

200 OK

success!

400 Bad Request

wrong input parameter or URL

401 Unauthorized

user authentication failed; incorrect credentials

403 Forbidden

user authorisation failed; operation not permitted for user

404 Not Found

The resource was not found.

  • subscriber = <msisdn>

  • offer = <offerId>

409 Conflict

Invalid operation due to current offer state.

500 Internal Server Error

A server side error occurred while processing the request.