Skip to main content
POST
Moody's municipal bond instrument ratings
Access requires an existing license with Moody’s.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
cursor
string | null

The next_cursor of the previous page. Leave out, or send null, for the first page. Only cursor and limit may change between pages. See Pagination.

isins
string[]

International Securities Identification Number (ISIN), unique 12-character code for the security.

Required string length: 12
limit
integer
default:100

Number of results per page, at most your tier's response size limit. A limit of 0 returns only total, the number of matching results.

Required range: x >= 0
sort
enum<string>[]

Fields to sort by. Prefix a field with '-' for descending order. Results with no value come last. See Order for how ties are broken.

Available options:
-cusip,
-duration_code,
-duration_text,
-is_deleted,
-issuer_legal_name,
-issuer_organization_id,
-moodys_instrument_id,
-moodys_rating_id,
-obligor_legal_name,
-obligor_organization_id,
-rating_class_number,
-rating_class_text,
-rating_date,
-rating_direction_code,
-rating_direction_text,
-rating_termination_date,
-rating_text,
-rating_type_code,
-rating_type_text,
-seniority_code,
-seniority_text,
-shadow_code,
-shadow_text,
-updated_at,
-watchlist_date,
-watchlist_direction_code,
-watchlist_direction_text,
-watchlist_termination_date,
cusip,
duration_code,
duration_text,
is_deleted,
issuer_legal_name,
issuer_organization_id,
moodys_instrument_id,
moodys_rating_id,
obligor_legal_name,
obligor_organization_id,
rating_class_number,
rating_class_text,
rating_date,
rating_direction_code,
rating_direction_text,
rating_termination_date,
rating_text,
rating_type_code,
rating_type_text,
seniority_code,
seniority_text,
shadow_code,
shadow_text,
updated_at,
watchlist_date,
watchlist_direction_code,
watchlist_direction_text,
watchlist_termination_date
updated_since
string<date-time>

Optional filter to only return ratings added or changed since the given UTC instant.

Accepts an ISO-8601 date-time (YYYY-MM-DDThh:mm:ssZ).

To poll for updates, pass the time you requested the first page of your previous poll, then upsert the results by moodys_instrument_id, rating_class_number and rating_date: some may be ratings you already have.

Response

Moody's municipal instrument ratings

data
object[]
required

One page of at most limit results. See Pagination.

next_cursor
string | null
required

Send as cursor to get the next page. null on the last page, or when limit is 0.

total
integer
required

Total number of results in the database that match the query filters.