openapi: 3.2.0
info:
title: OpenAPI definition Credit Analysis API
version: v0
description: Credit Analysis
servers:
- url: https://api.pitchbook.com
tags:
- name: Credit Analysis
description: Credit Analysis
paths:
/credit-analysis/credit-news/search:
get:
tags:
- Credit Analysis
summary: Credit News Search
description: Retrieves main info about the Credit news articles matching the specified criteria
operationId: creditNewsSearch
parameters:
- name: authors
in: query
description: Articles can be found by their authors. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: John Atkins, Glen Fest
- name: regions
in: query
description: Search for articles by the regions covered in them. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: Europe, United States
- name: assetClasses
in: query
description: Search for articles by the asset classes covered in them. Use a comma to separate multiple values
required: false
style: form
explode: true
schema:
type: string
example: CLO, Bonds
- name: topics
in: query
description: Articles can be found by their topics. Use a comma to separate multiple values
required: false
style: form
explode: true
schema:
type: string
example: ' People, Trends'
- name: issuer
in: query
description: Accepts issuer names, pbIds, websites, and tickers. Returns a list of entities that are an exact match. Use a comma to separate multiple values
required: false
style: form
explode: true
schema:
type: string
example: 11111-11, Tesla
- name: lender
in: query
description: Accepts lender names, pbIds, websites, and tickers. Returns a list of entities that are an exact match. Use a comma to separate multiple values
required: false
style: form
explode: true
schema:
type: string
example: 11111-11, Tesla
- name: sponsor
in: query
description: Accepts sponsor names, pbIds, websites, and tickers. Returns a list of entities that are an exact match. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: 11111-11, Tesla
- name: sinceDate
in: query
description: Add this parameter to extract news articles published after a certain date with the > operator, before a certain date with the < operator and between two dates with the ^ operator
required: false
style: form
explode: true
schema:
type: string
example: <2023-07-20
- name: page
in: query
description: Results are returned so that they can be paged through. Set this parameter to increment the page. If nothing is specified, default value is 1.
required: false
style: form
explode: true
schema:
type: string
example: '1'
- name: perPage
in: query
description: Set how many returned results will be shown on the page (between 1 and 250). If nothing is specified, default value is 25.
required: false
style: form
explode: true
schema:
type: string
example: '25'
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/CreditNewsSearchPageDto'
security:
- pbToken: []
/credit-analysis/credit-news/most-recent:
get:
tags:
- Credit Analysis
summary: Most Recent Credit News
description: Retrieves up to 250 of the most recently published articles and their associated descriptions (excluding article content). Users can specify page number parameter to retrieve older articles.
operationId: getMostRecentCreditNews
parameters:
- name: page
in: query
description: Results are returned so that they can be paged through. Set this parameter to increment the page
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 1
- name: perPage
in: query
description: How many returned results show on the page
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 25
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/MostRecentCreditNewsDto'
security:
- pbToken: []
/credit-analysis/credit-news/{articleId}:
get:
tags:
- Credit Analysis
summary: Credit News
description: Retrieves full article content for specific article IDs
operationId: getCreditNewsById
parameters:
- name: articleId
in: path
description: News articleId
required: true
style: simple
explode: false
schema:
type: integer
examples:
'2142401':
summary: '2142401'
value: 2142401
'5312405':
summary: '5312405'
value: 5312405
'1312103':
summary: '1312103'
value: 1312103
'6052303':
summary: '6052303'
value: 6052303
'11041384':
summary: '11041384'
value: 11041384
'6052302':
summary: '6052302'
value: 6052302
'2242405':
summary: '2242405'
value: 2242405
'6062401':
summary: '6062401'
value: 6062401
'5302402':
summary: '5302402'
value: 5302402
'5312104':
summary: '5312104'
value: 5312104
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/CreditNewsDto'
security:
- pbToken: []
/credit-analysis/credit-news:
post:
tags:
- Credit Analysis
summary: '[Bulk] Credit News'
description: Returns whole information about the specified Credit News articles. This bulk call allows you to send multiple articleIds within a single API call
operationId: getBatchCreditNews
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreditNewsBulkRequestDto'
example:
items:
- articleId: 11041384
- articleId: 2142401
- articleId: 5302402
required: true
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/CreditNewsBulkResponseDto'
security:
- pbToken: []
/credit-analysis/credit-news/{articleId}/attachment:
get:
tags:
- Credit Analysis
summary: Credit News Attachment
description: Retrieves an exact attachment file for a specific article.
operationId: downloadAttachment
parameters:
- name: articleId
in: path
description: News articleId
required: true
style: simple
explode: false
schema:
type: integer
examples:
'2142401':
summary: '2142401'
value: 2142401
'5312405':
summary: '5312405'
value: 5312405
'1312103':
summary: '1312103'
value: 1312103
'6052303':
summary: '6052303'
value: 6052303
'11041384':
summary: '11041384'
value: 11041384
'6052302':
summary: '6052302'
value: 6052302
'2242405':
summary: '2242405'
value: 2242405
'6062401':
summary: '6062401'
value: 6062401
'5302402':
summary: '5302402'
value: 5302402
'5312104':
summary: '5312104'
value: 5312104
- name: name
in: query
description: Attachment Name
required: true
style: form
explode: true
schema:
type: string
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
default:
description: default response
content:
'*/*':
schema:
type: string
example: Binary file content
security:
- pbToken: []
/credit-analysis/credit-research/search:
get:
tags:
- Credit Analysis
summary: Credit Research Search
description: Retrieves main info about the Credit Research reports matching the specified criteria
operationId: creditResearchSearch
parameters:
- name: authors
in: query
description: Reports can be found by their authors. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: Jack Jonson
- name: regions
in: query
description: Search for reports by the regions covered in them. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: United States
- name: assetClasses
in: query
description: Search for reports by the asset classes covered in them. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: Bonds
- name: reportTypes
in: query
description: Reports can be found by their report types. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: Snapshot
- name: marketTypes
in: query
description: Search for reports by the market types covered in them. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: Primary Market
- name: companyNames
in: query
description: Accepts company names, pbIds, websites, and tickers. Returns a list of companies that are an exact match. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: Aris Mining, 432919-99
- name: purposes
in: query
description: Search for reports by the purposes covered in them. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: M&A
- name: fileTypes
in: query
description: Reports can be found by their file types. Use a comma to separate multiple values.
required: false
style: form
explode: true
schema:
type: string
example: PDF
- name: sinceDate
in: query
description: Add this parameter to extract reports published after a certain date with the > operator, before a certain date with the < operator and between two dates with the ^ operator.
required: false
style: form
explode: true
schema:
type: string
example: '>2024-04-26'
- name: page
in: query
description: Results are returned so that they can be paged through. Set this parameter to increment the page. If nothing is specified, default value is 1.
required: false
style: form
explode: true
schema:
type: string
example: '1'
- name: perPage
in: query
description: Set how many returned results will be shown on the page (between 1 and 250). If nothing is specified, default value is 25.
required: false
style: form
explode: true
schema:
type: string
example: '50'
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/CreditResearchPageDto'
security:
- pbToken: []
/credit-analysis/credit-research/{reportId}/download:
get:
tags:
- Credit Analysis
summary: Credit Research Download
description: Retrieves an exact file of a specific report.
operationId: creditResearchDownload
parameters:
- name: reportId
in: path
description: Report ID
required: true
style: simple
explode: false
schema:
type: integer
format: int32
- name: fileName
in: query
description: Report filename
required: true
style: form
explode: true
schema:
type: string
- name: fileType
in: query
description: Report filetype
required: true
style: form
explode: true
schema:
type: string
responses:
'400':
description: Bad Request
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'500':
description: Internal Server Error
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'404':
description: Not Found
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'503':
description: Service Unavailable
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'403':
description: Forbidden
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'504':
description: Gateway Timeout
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'402':
description: Payment Required
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
'429':
description: Too Many Requests
content:
'*/*':
schema:
$ref: '#/components/schemas/ErrorDto'
default:
description: default response
content:
'*/*':
schema:
type: string
example: Binary file content
security:
- pbToken: []
components:
schemas:
CreditNewsStatsDto:
type: object
properties:
total:
type: integer
format: int32
example: 226326
perPage:
type: integer
format: int32
example: 25
page:
type: integer
format: int32
example: 1
lastPage:
type: integer
format: int32
example: 75442
CreditResearchPageDto:
type: object
properties:
stats:
$ref: '#/components/schemas/CreditResearchStatsDto'
items:
type: array
items:
$ref: '#/components/schemas/ResearchReportDto'
CreditNewsSearchPageDto:
type: object
properties:
stats:
$ref: '#/components/schemas/CreditNewsStatsDto'
items:
type: array
items:
$ref: '#/components/schemas/CreditNewsItemDto'
CreditNewsBulkRequestDto:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/CreditNewsBulkItemDto'
CreditNewsBulkStatsDto:
type: object
properties:
total:
type: integer
format: int32
example: 1
found:
type: integer
format: int32
example: 1
notFound:
type: integer
format: int32
example: 0
duplicates:
type: integer
format: int32
example: 0
ErrorDto:
type: object
properties:
reason:
type: string
enum:
- 100 CONTINUE
- 101 SWITCHING_PROTOCOLS
- 102 PROCESSING
- 103 EARLY_HINTS
- 103 CHECKPOINT
- 200 OK
- 201 CREATED
- 202 ACCEPTED
- 203 NON_AUTHORITATIVE_INFORMATION
- 204 NO_CONTENT
- 205 RESET_CONTENT
- 206 PARTIAL_CONTENT
- 207 MULTI_STATUS
- 208 ALREADY_REPORTED
- 226 IM_USED
- 300 MULTIPLE_CHOICES
- 301 MOVED_PERMANENTLY
- 302 FOUND
- 302 MOVED_TEMPORARILY
- 303 SEE_OTHER
- 304 NOT_MODIFIED
- 305 USE_PROXY
- 307 TEMPORARY_REDIRECT
- 308 PERMANENT_REDIRECT
- 400 BAD_REQUEST
- 401 UNAUTHORIZED
- 402 PAYMENT_REQUIRED
- 403 FORBIDDEN
- 404 NOT_FOUND
- 405 METHOD_NOT_ALLOWED
- 406 NOT_ACCEPTABLE
- 407 PROXY_AUTHENTICATION_REQUIRED
- 408 REQUEST_TIMEOUT
- 409 CONFLICT
- 410 GONE
- 411 LENGTH_REQUIRED
- 412 PRECONDITION_FAILED
- 413 PAYLOAD_TOO_LARGE
- 413 REQUEST_ENTITY_TOO_LARGE
- 414 URI_TOO_LONG
- 414 REQUEST_URI_TOO_LONG
- 415 UNSUPPORTED_MEDIA_TYPE
- 416 REQUESTED_RANGE_NOT_SATISFIABLE
- 417 EXPECTATION_FAILED
- 418 I_AM_A_TEAPOT
- 419 INSUFFICIENT_SPACE_ON_RESOURCE
- 420 METHOD_FAILURE
- 421 DESTINATION_LOCKED
- 422 UNPROCESSABLE_ENTITY
- 423 LOCKED
- 424 FAILED_DEPENDENCY
- 425 TOO_EARLY
- 426 UPGRADE_REQUIRED
- 428 PRECONDITION_REQUIRED
- 429 TOO_MANY_REQUESTS
- 431 REQUEST_HEADER_FIELDS_TOO_LARGE
- 451 UNAVAILABLE_FOR_LEGAL_REASONS
- 500 INTERNAL_SERVER_ERROR
- 501 NOT_IMPLEMENTED
- 502 BAD_GATEWAY
- 503 SERVICE_UNAVAILABLE
- 504 GATEWAY_TIMEOUT
- 505 HTTP_VERSION_NOT_SUPPORTED
- 506 VARIANT_ALSO_NEGOTIATES
- 507 INSUFFICIENT_STORAGE
- 508 LOOP_DETECTED
- 509 BANDWIDTH_LIMIT_EXCEEDED
- 510 NOT_EXTENDED
- 511 NETWORK_AUTHENTICATION_REQUIRED
message:
type: string
CreditNewsBulkResponseDto:
type: object
properties:
stats:
$ref: '#/components/schemas/CreditNewsBulkStatsDto'
found:
type: array
items:
$ref: '#/components/schemas/CreditNewsDto'
notFound:
type: array
items:
type: integer
format: int32
duplicates:
type: array
items:
$ref: '#/components/schemas/DuplicatedCreditNewsItemDto'
MostRecentCreditNewsDto:
type: object
properties:
stats:
$ref: '#/components/schemas/CreditNewsStatsDto'
items:
type: array
items:
$ref: '#/components/schemas/CreditNewsItemDto'
CreditNewsDto:
type: object
properties:
articleId:
type: integer
format: int32
example: 5598589
title:
type: string
example: Angel Investor
authors:
type: array
items:
$ref: '#/components/schemas/AuthorDto'
regions:
type: array
example:
- Europe
items:
type: string
example: '["Europe"]'
publishDate:
type: string
format: date-time
assetClasses:
type: array
example:
- Leveraged Loans
items:
type: string
example: '["Leveraged Loans"]'
topics:
type: array
example:
- Break
items:
type: string
example: '["Break"]'
issuer:
$ref: '#/components/schemas/NewsBusinessEntityDto'
lender:
$ref: '#/components/schemas/NewsBusinessEntityDto'
sponsor:
$ref: '#/components/schemas/NewsBusinessEntityDto'
articleBody:
type: string
example: Inmar has completed its $950 million term loan B due May 2026 wide of talk at pricing of Sofr+550, with a 0.5% floor and an OID of 96.5 through a Jefferies-led arranger group, according to sources.
attachments:
type: array
items:
$ref: '#/components/schemas/AttachmentDto'
deal:
$ref: '#/components/schemas/DealDto'
AttachmentDto:
type: object
properties:
name:
type: string
example: LCD Research HY Monthly May.pdf
url:
type: string
example: https://api.pitchbook.com/credit-analysis/credit-news/12503248/attachment?name=LCD%20Research%20HY%20Monthly%20May.pdf
AuthorDto:
type: object
properties:
authorName:
type: string
example: Jack Jonson
DealDto:
type: object
properties:
dealId:
type: string
example: 108911-98T
CreditResearchCompanyDto:
type: object
properties:
companyId:
type: string
example: 432919-99
companyName:
type: string
example: Aris Mining
CreditNewsItemDto:
type: object
properties:
articleId:
type: integer
format: int32
example: 5598589
title:
type: string
example: Angel Investor
authors:
type: array
items:
$ref: '#/components/schemas/AuthorDto'
regions:
type: array
example:
- Europe
items:
type: string
example: '["Europe"]'
publishDate:
type: string
format: date-time
assetClasses:
type: array
example:
- Leveraged Loans
items:
type: string
example: '["Leveraged Loans"]'
topics:
type: array
example:
- Break
items:
type: string
example: '["Break"]'
issuer:
$ref: '#/components/schemas/NewsBusinessEntityDto'
lender:
$ref: '#/components/schemas/NewsBusinessEntityDto'
sponsor:
$ref: '#/components/schemas/NewsBusinessEntityDto'
deal:
$ref: '#/components/schemas/DealDto'
DuplicatedCreditNewsItemDto:
type: object
properties:
articleId:
type: integer
format: int32
example: 42096268
occurrence:
type: integer
format: int32
example: 1
CreditNewsBulkItemDto:
type: object
properties:
articleId:
type: integer
format: int32
ResearchReportDto:
type: object
properties:
reportId:
type: integer
format: int32
example: 324
title:
type: string
example: US High-Yield Bond Daily PlayBook
description:
type: string
example: US High-Yield Bond Daily PlayBook is a daily report that provides a comprehensive overview of the US high-yield bond market.
authors:
type: array
items:
$ref: '#/components/schemas/AuthorDto'
regions:
type: array
example:
- United States
items:
type: string
example: '["United States"]'
assetClasses:
type: array
example:
- Bonds
items:
type: string
example: '["Bonds"]'
publishDate:
type: string
format: date
example: '2024-01-01'
reportType:
type: string
example: Snapshot
companies:
type: array
items:
$ref: '#/components/schemas/CreditResearchCompanyDto'
purposes:
type: array
example:
- M&A
items:
type: string
example: '["M&A"]'
attachments:
type: array
items:
$ref: '#/components/schemas/ReportFileDto'
ReportFileDto:
type: object
properties:
name:
type: string
example: September_2023_Global_Loan_Statistics_Report.pdf
type:
type: string
example: PDF
url:
type: string
example: https://api.pitchbook.com/credit-analysis/credit-research/246/download?fileName=September_2023_Global_Loan_Statistics_Report.pdf&fileType=PDF
CreditResearchStatsDto:
type: object
properties:
total:
type: integer
format: int32
example: 226326
perPage:
type: integer
format: int32
example: 25
page:
type: integer
format: int32
example: 1
lastPage:
type: integer
format: int32
example: 75442
NewsBusinessEntityDto:
type: object
properties:
pbId:
type: string
example: 10089-64
name:
type: string
example: Wafra Partners
securitySchemes:
pbToken:
type: apiKey
name: Authorization
in: header
scheme: bearer
bearerFormat: JWT