List coupon - client mode

Production

https://api.mediaconnect.no/capi

GET

/v1/client/coupon/{productCode}

Only the client needs to be logged in to use this endpoint. The user does not need to be logged in, click here to read more.

This API returns all coupons for a subscription product. You may also use this API to check the price at the next renewal.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.mediaconnect.no/capi/v1/client/coupon/?marketing'

Response Example

200 - Success

{
    "coupons": [
        {
            "couponCode": "DataNews",
            "couponNumber": 27,
            "startTime": 1529405788000,
            "endTime": 1534676188000,
            "description": "Students only",
            "couponPrice": "299",
            "periodLength": "1",
            "periodType": "months",
            "extraProducts": [
                {
                    "productId": "29542",
                    "description": "Newspaper about ICT"
                }
            ],
            "renewal": {
                "renewalPrice": "199",
                "periodLength": "1",
                "periodType": "months"
            },
            "marketing": {
                "project": "Kundeservice",
                "market": "ICT",
                "activity": "SNU",
                "salesMethod": "TM"
            }
        }
    ]
}

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://connectid.no/user/oauth/token

Refresh URL: https://connectid.no/user/oauth/token

Scopes:

read-For all access

Path Params

productCode

string

required

Query Params

marketing

boolean

optional

Informs if marketing data should be return in the response:

true: Marketing data should be included in the response.

false: Marketing data should not be included in the response.

Responses

🟢200OK

application/json

Body

coupons

array [object {12}]

optional

couponCode

string

optional

Coupon code

<= 12 characters

couponNumber

integer

optional

Coupon number

startTime

integer

optional

Start time, i.e time coupon can be used from.

Unix Epoch timestamps in milliseconds since 1st January 1970 UTC.

endTime

integer

optional

End time, i.e time coupon no longer can be used.

Unix Epoch timestamps in milliseconds since 1st January 1970 UTC.

description

string

optional

Coupon description

<= 255 characters

couponPrice

number

optional

Coupon price/amount

Multiple of:

0.01

periodLength

integer

optional

Initial period length

>= 1<= 32767

periodType

enum<string>

optional

The unit of the period length. Use one of these:

days

months

years

issues

Allowed values:

daysmonthsyearsissues

productDeliveryPlanId

integer

optional

The unique id for productdeliveryplan

extraProducts

array [object {2}]

optional

renewal

object

optional

marketing

object

optional

🟠400Bad Request

🟠429Too Many Requests

🔴500Server Error

Modified at 2025-06-17 07:34:31

Check coupon price - client mode

List coupon for coupon number - client mode