Query the current user's partner subscriptions.

curl --request GET \
  --url https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "partnerSubscriptionId": "<string>",
    "partnerCustomerId": "<string>",
    "organizationId": "<string>",
    "organizationCode": "<string>",
    "partnerOrganizationId": "<string>",
    "accountId": "<string>",
    "accountVid": "<string>",
    "subscriptionId": "<string>",
    "subscriptionVid": "<string>",
    "subscriptionItemId": "<string>",
    "externalPartnerSubscriptionId": "<string>",
    "registrationString": "<string>",
    "partnerUrl": "<string>",
    "partnerTokenizedUrl": "<string>",
    "partnerCode": "<string>",
    "productCode": "<string>",
    "slmProductCode": "<string>",
    "createdDate": "<string>",
    "updatedDate": "<string>",
    "startServiceDate": "<string>",
    "endServiceDate": "<string>",
    "activatedDate": "<string>",
    "serviceStatus": "UNPROVISIONED",
    "state": "<string>",
    "billingStatus": "PENDING-VALIDATION",
    "type": "ENTITLEMENT",
    "billingPaymentMethod": "<string>",
    "redemptionCodeExpirationTime": "2025-02-22T17:30:09.000Z",
    "retryable": false,
    "reasonCode": "<string>",
    "metadata": {}
  }
]

{
  "code": "invalid-request",
  "message": "<string>",
  "validationErrors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "not-found",
  "message": "<string>"
}

{
  "code": "server-error",
  "message": "<string>"
}

GET

partnerSubscription

Query the current user's partner subscriptions.

curl --request GET \
  --url https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://default.ulm.stg.m1amdocs.io/storefront/partnerSubscription")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "partnerSubscriptionId": "<string>",
    "partnerCustomerId": "<string>",
    "organizationId": "<string>",
    "organizationCode": "<string>",
    "partnerOrganizationId": "<string>",
    "accountId": "<string>",
    "accountVid": "<string>",
    "subscriptionId": "<string>",
    "subscriptionVid": "<string>",
    "subscriptionItemId": "<string>",
    "externalPartnerSubscriptionId": "<string>",
    "registrationString": "<string>",
    "partnerUrl": "<string>",
    "partnerTokenizedUrl": "<string>",
    "partnerCode": "<string>",
    "productCode": "<string>",
    "slmProductCode": "<string>",
    "createdDate": "<string>",
    "updatedDate": "<string>",
    "startServiceDate": "<string>",
    "endServiceDate": "<string>",
    "activatedDate": "<string>",
    "serviceStatus": "UNPROVISIONED",
    "state": "<string>",
    "billingStatus": "PENDING-VALIDATION",
    "type": "ENTITLEMENT",
    "billingPaymentMethod": "<string>",
    "redemptionCodeExpirationTime": "2025-02-22T17:30:09.000Z",
    "retryable": false,
    "reasonCode": "<string>",
    "metadata": {}
  }
]

{
  "code": "invalid-request",
  "message": "<string>",
  "validationErrors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "code": "<string>",
  "message": "<string>"
}

{
  "code": "not-found",
  "message": "<string>"
}

{
  "code": "server-error",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth 2.0 Authentication

Query Parameters

subscriptionId

string

The ID of a subscription.

type

enum<string>

default:BILLING

The category of Partner subscription to retrieve

Available options:

BILLING,

ENTITLEMENT

Response

partnerSubscriptionId

string

MarketONE partner service provisioning record identifier.

Maximum string length: 256

partnerCustomerId

string

MarketONE unique customer identifier per partner.

Maximum string length: 256

organizationId

string

The ID of the aggregator organization in MarketONE for which this record was created.

Maximum string length: 50

organizationCode

string

The organization code as set by the admin in MarketONE.

partnerOrganizationId

string

The ID of the partner organization in MarketONE for which this record was created.

accountId

string

The ID of the MarketONE account associated with this partner service record. This ID is not returned when the API is called with a partner API key. This will be returned withwhen the API is called with an aggregator API key.

Maximum string length: 128

accountVid

string

The id of the SLM subscription associated with this partner service given by SLM in its response.

Maximum string length: 128

subscriptionId

string

The id of the SLM subscription associated with this partner service.

Maximum string length: 128

subscriptionVid

string

The id of the SLM subscription associated with this partner service given by SLM in its response.

Maximum string length: 128

subscriptionItemId

string

The id of the SLM subscription Item associated with this partner service.

Maximum string length: 128

externalPartnerSubscriptionId

string

The identifier returned by the partner from the "AddSubscription" callback.

Maximum string length: 256

registrationString

string

Information that was sent to the partner as part of the "AddSubscription" callback; e.g. registration code

Maximum string length: 2048

partnerUrl

string

The optional response value that identifies the Url where user will be directed to for entering the registration code and completing the registration

Maximum string length: 2048

partnerTokenizedUrl

string

The optional response value that identifies the complete one click url that can be used by the user for activation of his partner subscription.

Maximum string length: 2048

partnerCode

string

The partner code as set by the partner admin in MarketONE.

Maximum string length: 15

productCode

string

The product code defined by the partner identified by partner code.

Maximum string length: 128

slmProductCode

string

The offer code defined by the CSP and maintained in SLM.

Maximum string length: 128

createdDate

string

The timestamp (ISO 8601 format) when the partner service provisioning information record was created.

updatedDate

string

The timestamp (ISO 8601 format) when the partner service provisioning information record was updated.

startServiceDate

string

The timestamp (ISO 8601 format) when the partner service provisioning information record was created.

endServiceDate

string

The timestamp (ISO 8601 format) when the partner service provisioning information record was updated.

activatedDate

string

The timestamp (ISO 8601 format) when the partner subscription was activated (optional)

serviceStatus

enum<string>

Status of the partner service MarketONE information. UNPROVISIONED indicates that the record was created by the callback response was not received. INACTIVE indicates the provisioning callback was sucesfully received by the partner service, but it has not been claimed by any service user yet. ACTIVE indicates that the service entitlement has been sucesfully provisioned, and a partner service user has claimed it. CANCELLATION-IN-PROGRESS indicates that the a de-provisioning request is pending. CANCELLED indicates that the de-provisioning request confirmation has been received.

Available options:

UNPROVISIONED,

INACTIVE,

ACTIVE,

CANCELLATION-IN-PROGRESS,

CANCELLED,

UPDATE-IN-PROGRESS,

PAUSED,

PAUSE-IN-PROGRESS,

RESUME-IN-PROGRESS

Maximum string length: 50

state

string

Current state of the calls in regards to Create, Cancel and Reprovision Subscriptions. Used for state machine orchestration for MarketONE managed subscriptions.

Maximum string length: 50

billingStatus

enum<string>

The status of the OTT billing partner subscription. PENDING-VALIDATION - the BILLING partner subscription creation was requested by the OTT partner and it requires validation, MarketONE triggered the OTP notification, aggregator sends the OTP to the consumer. The customer aggregator account details have not yet been validated as being correct. E.g. a MSISDN was provided, but we have not yet verified it belongs to the user. PENDING-CONFIRMATION - MarketONE successfully validated the BILLING partner subscription. All the BILLING partner subscription details are validated at this point, MarketONE awaiting confirmation from the customer via the OTT partner that they wish this partner subscription to be active for billing. ACTIVE - the BILLING partner subscription is available for billing CANCELLED - the BILLING partner subscription was canceled and can no longer be used for charges, but may be used for refunds if it had previously been active.

Available options:

PENDING-VALIDATION,

PENDING-CONFIRMATION,

ACTIVE,

CANCELLED

Maximum string length: 50

type

enum<string>

the type of the partner subscription record; ENTITLEMENT - is when the partner subscription is represeting a entitlement relationship; BILLING - when the partner subscription is representing a billing relationship.

Available options:

ENTITLEMENT,

BILLING

billingPaymentMethod

string

A unique identifier.

Maximum string length: 256

redemptionCodeExpirationTime

string

The timestamp (ISO 8601 format) about the partner service redemption code will get expiration.

Example:

"2025-02-22T17:30:09.000Z"

retryable

boolean

default:false

Indicates whether the provisioning is retryable in case of failure.

reasonCode

string

Reason code for partner subscription cancellation.

metadata

object

A set of key/value pairs that you can attach to an object. Useful for storing additional information.

Show child attributes

Home

Introduction

For Merchants

For Resellers

Partner Ecosystem Management

Commerce Engine

Storefront Experience

APIs

Query the current user's partner subscriptions.

Authorizations

Query Parameters

Response