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 |