web_api_commercialpapers_doc

WebApi Commercial Papers Technical Documentation for ListingCenter application

Version: 15

Date: 2026-01-29

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 commercial paper

An example of a request to create a commercial paper in JavaScript

var data = JSON.stringify({"exchangeCountry":"SWE","issuer":"Acme (publ)","applicationName":"ACMR_202_CD_IO", 
								"commercialPaper":{"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/commercialpapers/create");
xhr.setRequestHeader("Authorization", "Bearer eyJraWQiOiIwQ3VlX2tJZEFya0JRVnRJ...VmLB4M6pXnQ");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

HTTP request:

POST /api/v15/commercialpapers/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 commercial paper
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

- Updated sustainableBondGroup to allow Sustainability Linked Loans financing Bond, Climate Transition Bond, Other Bond

v13 changes

- Added a field supportingDocumentsBase64 to support of submitting an attached supoporting documents using Base64 encoding
- For a FinalTermsDocument class, added a field base64Data to support of submitting a final terms documents using Base64 encoding (must be PDF file)
- For a FinalTermsDocument class, added a field fileName to support of submitting a final terms documents using Base64 encoding (must be PDF file)
- For a StandAloneProspectusDocument class, added a field base64Data to support of submitting a final terms documents using Base64 encoding
- For a StandAloneProspectusDocument class, added a field mimeType to support of submitting a final terms documents using Base64 encoding
- For a StandAloneProspectusDocument class, added a field fileName to support of submitting a final terms documents using Base64 encoding

v8 changes

- Removed a field issuersRequestOfAdmissionToTrading of IssueSpecificInfo
- Removed a field timeZone of IssueSpecificInfo

- Added a field internalDecisionRequest

WebApi methods

CommercialPapers

Method Parameter Name Parameter Type Description Http Parameters
Create returns AppIdAndGuid HTTP POST method
route: /CommercialPapers/Create
commercialPaper NewCommercialPaper

Classes description

Address

Property Name Property Type Description Required Validation Rules
address String * Maximum length: 64
address2 String Maximum length: 64
city String * Maximum length: 50
province String Maximum length: 50
zip String * Maximum length: 50
country String 2 letter country code * Maximum length: 2

Affirmation

Property Name Property Type Description Required Validation Rules
afrmnName String Affirmation Name * Maximum length: 50
afrmnTitleOrFirm String Affirmation Title/Firm * Maximum length: 100
afrmnDate DateTime Affirmation Date *
afrmnInitials String Affirmation Initials * Maximum length: 4
afrmnEmail String Affirmation Email Must be a valid email address
Maximum length: 64
afrmnPhoneNb String Affirmation phone number Maximum length: 50

Contact

Property Name Property Type Description Required Validation Rules
name String * Maximum length: 128
titleFirm String Title/Firm Maximum length: 128
phone String * Maximum length: 32
email String * Maximum length: 128
Must be a valid email address

NewCommercialPaper

Property Name Property Type Description Required Validation Rules
commercialPaper CommercialPaperModel *
exchangeCountry String Exchange Country code * Must be one of "SWE; FIN; DEN" (case sensitive)
Maximum length: 3
issuer String * Must be a valid issuer for Nordic country
Maximum length: 80
See list of current issuers at https://listingcenter.nasdaq.com

applicationName String Application name * Maximum length: 256
companyAddress Address Company Address *
contacts Contacts *
issueSpecificInfo IssueSpecificInfo Issue Specific Info *
affirmation Affirmation *
supportingDocumentsUrls String[] URL(s) for supporting document(s) Must be a valid URL
Only CSV, MS Word, MS Excel and PDF documents are allowed.
supportingDocumentsBase64 DocumentBase64[] Supporting document(s) encoded as Base64 Only CSV, MS Word, MS Excel and PDF documents are allowed.
finalTerms FinalTermsDocument[] Final Terms document(s) urls and associated ISINs All ISINs of intrument(s) have to have matching Final Terms document.
shareFormWith String[] Email addresses to share the form with

Contacts

Property Name Property Type Description Required Validation Rules
companyContact Contact *
additionalContact Contact

DocumentBase64

Property Name Property Type Description Required Validation Rules
fileName String * File name of the encoded document
mimeType String * Mime/type of the encoded document
base64Data String * A document encoded as Base64

CommercialPaperInstrument

Property Name Property Type Description Required Validation Rules
shortName String Short Name * Maximum length: 32
Must contain only correct symbol characters
fullName String Full Name * Must contain only correct symbol characters
Maximum length: 32
loanNumber String Loan Number Maximum length: 9
isinCode String ISIN code * Must be a valid ISIN code
Must be an unique ISIN code
fisnCode String FISN code * Maximum length: 35
cfiCode String CFI code * Must match regular expression: ^[a-zA-Z]{6,6}$
tradingLot Int32 Trading Lot *
instrumentCurrency String Instrument Currency * Must be a valid currency code
Maximum length: 3
Must be one of "EUR", "SEK", "DKK", "NOK", "USD", "JPY", "GBP", "TRY", "RON", "IDR", "CHF", "AUD", "BRL", "INR", "ZAR", "MXN", "NZD", "RON", "IDR", "HKD" and "CAD"
amountIssued Nullable<Double> Amount Issued
bondSeniority Nullable<BondSeniorityEnum> Bond Seniority
sustainableBondGroup Nullable<Int32> Sustainable Bond Group Must be one of 1 - Green Bond; 2 - Social Bond; 3 - Sustainability Bond; 4 - Sustainability Linked Bond; 5 - EU Green Bond Standard; 6 - Sustainability Linked Loans financing Bond; 7 - Climate Transition Bond; 8 - Other Bond
issueDate Nullable<DateTime> Issue date
interestFromDate Nullable<DateTime> Usually equals to Issue date. Will be set to Issue date if left blank. Mandatory if other than Issue date
reimbursementDate Nullable<DateTime> Reimbursement date Reimbursement date must occur within 365 days from the Issue date
lastTradingDate Nullable<DateTime> Last trading date
tradingCode String Trading code

CommercialPaperModel

Property Name Property Type Description Required Validation Rules
exchange String Exchange * Must be one of exchange codes "FNDK", "FNFI", "FNSE", "XCSE", "XHEL", "XSTO"
Maximum length: 4
market String Market * Maximum length: 32
Must be one of "STO Sustainable Commercial Paper; STO Commercial Papers" (case sensitive)
tradingCurrency String Trading Currency * Must be a valid currency code
Maximum length: 3
Must be one of "EUR", "SEK", "DKK", "NOK", "USD", "JPY", "GBP", "TRY", "RON", "IDR", "CHF", "AUD", "BRL", "INR", "ZAR", "MXN", "NZD", "RON", "IDR", "HKD" and "CAD"
programOrStandAlone String Program or Stand alone * Maximum length: 64
Must be one of "Program; Stand alone; Benchmark Program; Benchmark Stand alone" (case sensitive)
listingDate DateTime * Date must be in the future
issuerLEI String * Maximum length: 20
issuerCode String * Maximum length: 6
leadManagerCode String * Maximum length: 8
leadManagerExchangeCode String * Maximum length: 2
bondType String Bond Type * Must be one of "EUSB; OEPB; CVTB; CVDB; CRPB; OTHR" (case sensitive)
http://ec.europa.eu/finance/securities/docs/isd/mifid/rts/160714-rts-2-annex_en.pdf
clearingSystem String Clearing System Must be one of "Euroclear Sweden AB; Euroclear Bank SA/NV & Clearstream Banking S.A.; Euroclear Finland Oy; VP Securitites A/S; Verdipapirsentralen ASA; Euroclear UK & Ireland CREST; Nasdaq CSD (Latvia); Nasdaq CSD (Estonia); Nasdaq CSD (Lithuania); Nasdaq CSD (Iceland); Verðbréfamiðstöð Íslands" (case sensitive)
Mandatory field if the instrument is primarily registered in a foreign CSD but also settled at a Nordic CSD, then choose the Nordic CSD in the dropdown below.
instruments CommercialPaperInstrument[] * Minimal length: 1
Maximum length: 100

IssueSpecificInfo

Property Name Property Type Description Required Validation Rules
firstListingDate DateTime First Listing Date * Date must be in the future
internalDecisionRequest DateTime The Date and time of the issuer's internal decision to request admission to trading on a trading venue *
baseProspectusRecordId Int32 Base Prospectus Record Id * BaseProspectusRecordId = 0 for Stand-alone Prospectus or application id of a Base Prospectus

FinalTermsDocument

Property Name Property Type Description Required Validation Rules
base64Data String Final Terms PDF file encoded using Base64
fileName String A file name for the Base64 encoded PDF file name
url String Url of Final terms document Must be a valid URL
Only PDF documents accepted
isins String[] List of ISINs associated with the final terms document * Minimal length: 1
Must be a valid ISIN code

AppIdAndGuid

Property Name Property Type Description Required Validation Rules
appSysId Int32
guid Guid

Enums description

BondSeniorityEnum

Name Value
JUND J
MZZD M
SNDB S
SBOD U

App Store       Google Play       Listing Center Content RSS Feed
The Nasdaq Stock Market, Nasdaq, The Nasdaq Global Select Market, The Nasdaq Global Market, The Nasdaq Capital Market, ExACT and Exchange Analysis and Compliance Tracking system are trademarks of Nasdaq, Inc.
FINRA® and Financial Industry Regulatory Authority, Inc.® are registered trademarks of Financial Industry Regulatory Authority, Inc.