WebApi Bonds Technical Documentation for ListingCenter application

Version: 15

Date: 2026-03-12

End point information

Url: https://listingcenter.nasdaq.com/api/v15

Authentication: OAuth2

You can obtain client_id, client_secret and refresh token values from WebApi section of your profile page ( https://listingcenter.nasdaq.com/editprofile.aspx ). Refresh token (expiration time is 3 months) can be used to request an access token.

Using the values you can make an api call to request an access token (expiration time is 30 minutes)

Examples of API calls

Access token

An example of a request to obtain access token in JavaScript

var data = "grant_type=refresh_token&client_id=0326119b515d4eaca8411e7fb147aa06&client_secret=34458d40725f4911a78e2a3c36aace71&refresh_token=zEH11hcgeaigsm0tkfecH1fDC0CCE7LB6Llij9kqaj8";

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://listingcenter.nasdaq.com/api/v15/oauth2/token");
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

xhr.send(data);

HTTP request:

POST /api/v15/oauth2/token HTTP/1.1
Host: listingcenter.nasdaq.com
Content-Length: 172
Pragma: no-cache
Cache-Control: no-cache
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&client_id=0326119b515d4eaca8411e7fb147aa06&client_secret=34458d40725f4911a78e2a3c36aace71&refresh_token=zEH11hcgeaigsm0tkfecH1fDC0CCE7LB6Llij9kqaj8

HTTP response:

HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Date: Wed, 2 January 2022 15:00:04 GMT
Content-Length: 2028

{"access_token":"eyJraWQiOiIwQ3VlX2tJZEFya0JRVnRJNzI4Y1VnbXhiMkp0eGxaQ2NOM0ZMb3JnRE...E7LB6Llij9kqaj8","expires_in":3600,"scope":"openid profile offline_access","token_type":"Bearer"}}

Create a bond

An example of a request to create a bond in JavaScript

var data = JSON.stringify({"exchangeCountry":"SWE","issuer":"Acme (publ)","applicationName":"ACMR_202_CD_IO", 
								"bond":{"exchange": "XSTO", "segment": "STO Products", "tradingLot": 10000, "tradingCurrency": "SEK", "mtnOrStandAlone": "MTN", "listingDate": "2022-01-12"}});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://listingcenter.nasdaq.com/api/v15/bonds/create");
xhr.setRequestHeader("Authorization", "Bearer eyJraWQiOiIwQ3VlX2tJZEFya0JRVnRJ...VmLB4M6pXnQ");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

HTTP request:

POST /api/v15/bonds/create HTTP/1.1
Host: listingcenter.nasdaq.com
Content-Length: 239
Pragma: no-cache
Cache-Control: no-cache
Authorization: Bearer eyJraWQiOiIwQ3VlX2tJZ...VmLB4M6pXnQ
Content-Type: application/json
Accept: */*

{"exchangeCountry":"FIN","issuer":"Acme (publ)","applicationName":"ACMR_202_CD_IO", ..., "listingDate":"2022-01-14"}}

Successful HTTP response:

HTTP/1.1 200
Cache-Control: no-cache
Pragma: no-cache
Content-Length: 64
Content-Type: application/json; charset=utf-8
Expires: -1
Date: Wed, 13 January 2022 15:57:08 GMT

{"appSysId":12345,"guid":"a2f83ee1-bcf9-44e5-bd41-7383d128351b"}

Failed validation HTTP response:

HTTP/1.1 400 Bad Request
Cache-Control: no-cache
Pragma: no-cache
Content-Length: 1168
Content-Type: text/plain; charset=utf-8
Date: Wed, 13 January 2022 15:33:33 GMT

Not valid bond
Value for "Listing Date" must be in the future, but it is "2022-01-02"
Value for "Trading Currency" is required.
Value for "Issuer Code" is required.
...
Value for "Issue Specific Info" is required.
Value for "Affirmation" is required.
Value for "URL(s) for Final Terms document(s)" is required.

Changes

v15 changes

v13 changes

v10 changes

v8 changes

WebApi methods

Bonds

Classes description

Address

Affirmation

Contact

NewBond

Contacts

DocumentBase64

BondInstrument

BondModel

IssueSpecificInfo

FinalTermsDocument

StandAloneProspectusDocument

AppIdAndGuid

Enums description

CouponTypeEnum

CouponsPerYearEnum

DayAdjustmentMethodEnum

BondSeniorityEnum

IcelandAmortizationTypeEnum

IcelandIndexEnum