v1

latestOpenAPI 3.0.22026-08-06172357.6 KB

CUSIP

Search the CUSIP database using various filter parameters

get/cusip/search

Query parameters

qstring required

The syntax is <search field>:<search value> pair separated by colon and multiple <search field>:<search value> pairs can be connected by AND, OR and NOT logical operator.

Supported Search Fields

Search Field	Data Type	Example	Comment
cusip	string	cusip:023135106
isin	string	isin:US0231351067	International Securities Identification Number (ISIN) is an alpha numeric code that contains 12 characters
issuerName	string	issuerName:FactSet	Legal name of entity issuing securities
issuerNumber	string	issuerNumber:023135	The first six characters of a CUSIP identify the issuer of the security, whether a company, government agency or municipality.
issuerGroup	string	issuerGroup:C	C for CUSIP, I for CINS and P for Private Placement Number (PPN)
issuerType	string	issuerType:C	C for Corporate, M for Municipal and G for Government
issuerState	string	issuerState:NJ	The two-letter code used to identify U.S. states
issuerLogDate	date	issuerLogDate:[2023-10-29 TO 2023-11-30]<br>issuerLogDate:[2023-10-29 08:07:00 TO 2023-11-30 08:07:00]	Support both dates and timestamps.
domicile	string	domicile:US	Two-character ISO domicile code; country of incorporation for an issuer
currencyCode	string	currencyCode:USD	Three-character ISO currency code for a security.
issueNumber	string	issueNumber:10	The seventh and eighth characters of a CUSIP uniquely identify each issue from a given issuer.
issueDescription	string	issueDescription:COM	Name of security being issued.
issueType	string	issueType:E issueType:D	E for equity security, D for debt security
issueGroup	string	issueGroup:V	C for CUSIP, I for CINS, P for Private Placement Number (PPN), V for private equity/credit
rate	number	rate:[3.1 TO 3.4]	Coupon rate; the annual rate of interest payable on a security, expressed as a percentage.
maturityDate	date	maturityDate:[2016-10-29 TO 2016-11-30]	The date the principal comes due and payable to the security holder.
datedDate	date	datedDate:[2016-10-29 TO 2016-11-30]	The datedDate is also known as settlement date. It is the specific date from which interest begins to accrue on a fixed-income security
issueLogDate	date	issueLogDate:[2016-10-29 TO 2016-11-30]<br>issueLogDate:[2016-10-29 08:07:00 TO 2016-11-30 18:07:00]	The date/time when CUSIP data is updated. Support both dates and timestamps.
issueReleaseDate	date	issueReleaseDate:[2023-10-29 TO 2023-11-30]<br>issueReleaseDate:[2022-10-29 08:07:00 TO 2022-11-30 18:07:00]	The date/time when CUSIP data is created and released. Support both dates and timestamps.
tickerSymbol	string	tickerSymbol:AMZN<br/>tickerSymbol:(AMZN FDS MSFT)	Support multiple ticker symbols search.
mic	string	mic:XNAS	ISO 10383 operating MIC code
whereTraded	string	whereTraded:Nasdaq	Exchange name
usCfiCode	string	usCfiCode:ESVUVR	Accept six-letter US CFI (Classification of Financial Instruments) code
isoCfiCode	string	isoCfiCode:ESVUFR	Accept six-letter ISO CFI (Classification of Financial Instruments) code
lei	string	lei:ZXTILKJKG63JELOEG630<br/>lei:(ZXTILKJKG63JELOEG630 549300PCYWUCTLW37P50 2549009Y3WZIHLCUDO77)	The Legal Entity Identifier (LEI) is a 20-character, alpha-numeric code based on the ISO 17442 standard. Support multiple LEI search.
section13f	string	section13f:Y	CUSIP as disclosed in the quarterly SEC Form 13F filing
tokenizedSecurity	string	tokenizedSecurity:Y	Tokenized securities are digital representations of traditional financial assets

pageSizeinteger

Specifies the maximum number of CUSIP records to return in the response.

Accepts any integer between 1 and 10,000. Default is 10,000.

For trial users, the maximum number of records in the response is limited to 5

pageinteger

The page number in the search results. Use this parameter to navigate to paginated page.

Example: Any integer between 1 and 30. Default:1

Note: If the maximum pageSize and page number are used, the API can return up to 300,000 records per CUSIP search.

sortstring

Example:cusip asc

Specifies the field and direction for sorting the API response. Format: <sort field> <sort direction> (e.g., "cusip asc" or "rate desc"). If the sort direction is not provided, ascending (asc) is used by default.

Supported sort fields:

cusip
isin
issuerName
issuerNumber
maturityDate
rate
issueLogDate
issueReleaseDate

fieldListstring

Example:cusip,issuerName,issueDescription

Specify the response fields by providing a comma-separated list of field names.

Available fields:

cusip
isin
issuerNumber
issueNumber
issuerName
domicile
issuerGroup
issuerStatus
issuerType
issuerState
issuerLogDate
currencyCode
issueDescription
issueType
issueGroup
rate
maturityDate
datedDate
issueLogDate
issueReleaseDate
tickerSymbol
mic
whereTraded
usCfiCode
isoCfiCode
section13f

To return all CUSIP attributes, use: fieldList=all

Response

Successful retrieval of CUSIP search result.

Example response

{
  "response": {
    "header": {
      "totalCount": 1,
      "queryTime": 90,
      "query": "/cusip/search?q=cusip:303075105",
      "page": 1,
      "pageSize": 1000
    },
    "cusipRecords": [
      {
        "issuerName": "FACTSET RESH SYS INC",
        "domicile": "US",
        "issuerGroup": "C",
        "issuerStatus": "A",
        "issuerType": "C",
        "issuerState": "DE",
        "issuerLogDate": "08/25/2017",
        "issuerReleaseDate": "06/10/1996",
        "issuerTransactionCode": "L",
        "cabre": "US066405S1",
        "legalEntityName": "Northeast Bank",
        "lei": "549300F0LV9TSW34E306",
        "spac": "Y",
        "isin": "US3030751057",
        "issueGroup": "C",
        "issueType": "Equity",
        "issueDescription": "COM",
        "issueStatus": "A",
        "issueReleaseDate": "09/06/2024",
        "issueLogDate": "09/06/2024",
        "issueLogTimestamp": "09/06/2024 15:28:57",
        "maturityDate": "10/01/2035",
        "datedDate": "10/01/2025",
        "rate": 7.25,
        "currencyCode": "USD",
        "securityTypeDescription": "Revenue",
        "issueObligorName": "TOCCOA GA WTR & SWR REV",
        "fisn": "NORTHEAST BK PO/4.05 CTF DEP 202609",
        "usCfiCode": "DBFUFR",
        "isoCfiCode": "DBFUFR",
        "guarantee": "Unsecured",
        "tickerSymbol": "FDS",
        "mic": "XNAS",
        "whereTraded": "NYSE",
        "votingRights": "Voting",
        "sourceDocument": "TERM SHEET",
        "bondForm": "Registered",
        "rateType": "Fixed Rate",
        "preferredType": "Non Redeemable Exchangeable Extendible",
        "redemption": "Fixed Maturity",
        "callable": "N",
        "putable": "Y",
        "firstCouponDate": "10/01/2025",
        "paymentFrequency": "Semi Annually",
        "underwriter": "MULTI BANK SECURITIES",
        "bondCounsel": "Cravath Swaine & Moore",
        "financialAdvisor": "SECURITY BENEFIT GROUP OF COMPANIES",
        "offeringAmount": 43.5,
        "offeringAmountCode": "Million",
        "municipalSaleDate": "10/01/2025",
        "saleType": "C",
        "closingDate": "10/01/2025",
        "issueState": "NY",
        "paymentStatus": "Fully Pd. PAR Value",
        "depositoryEligible": "Y",
        "initialPublicOffering": "Y",
        "govermentStimulusProgram": "NA",
        "greenBondType": "Green Bond / Sustainability Bond",
        "greenBondCertifierVerifier": "Issuer Designated",
        "section13f": "Y",
        "ownershipRestrictions": "Free (Unrestricted)",
        "tokenizedSecurity": "Y",
        "tokenizationLevel": "FULL",
        "distributedLedgerName": "Ethereum",
        "equivalentDigitalTokenGroup": "9XB4LP5D8",
        "digitalTokenIdentifiers": "X9J9K872S"
      }
    ]
  }
}