Firms

GET /v1/firms

Every firm with an investor letter on bullpen.news, by name, for the letters endpoint's firm. It takes no parameters, and refuses any.

Parameters

None.

curl Python JavaScript

curl "https://api.bullpen.news/v1/firms" \
  -H "Authorization: Bearer $BULLPEN_KEY"

import os, requests

r = requests.get(
    "https://api.bullpen.news/v1/firms",
    headers={"Authorization": f"Bearer {os.environ['BULLPEN_KEY']}"},
)
r.raise_for_status()
print(r.json())

const r = await fetch('https://api.bullpen.news/v1/firms', {
	headers: { Authorization: `Bearer ${process.env.BULLPEN_KEY}` }
});
if (!r.ok) throw new Error((await r.json()).detail);
console.log(await r.json());

What comes back

Field	Type	Description
`firms`	array of object	Every firm with a letter on bullpen.news, by name.
`firms[].slug`	string	The firm's slug on bullpen.news.
`firms[].name`	string	The firm's name, as letters' firm gives it.

Header	Sent with	Description
`Request-Id`	every answer	This request's id, such as req_ followed by 24 letters and digits. Quote it to support.
`RateLimit-Policy`	200, 400, 429, 500, 503	Your plan's quotas, per minute and per day (IETF draft-11). It may change to match the RFC.
`RateLimit`	200, 400, 429, 500, 503	What each window has left, and the seconds until it resets (IETF draft-11).
`WWW-Authenticate`	401	Bearer realm="bullpen.news"
`Retry-After`	429, 503	How many seconds to wait.

GET /v1/firmsThe first 3 of 190 firms.

{
  "firms": [
    {
      "slug": "1-main-capital",
      "name": "1 Main Capital"
    },
    {
      "slug": "1851-capital",
      "name": "1851 Capital"
    },
    {
      "slug": "advisory-research",
      "name": "Advisory Research"
    }
  ]
}

Status codes

Status	Meaning	Codes
`200`	The answer.
`400`	A parameter is invalid or unknown (invalid_request), a key is in the URL (key_in_url), or a cursor is not this call's (invalid_cursor).	`key_in_url`, `invalid_request`, `invalid_cursor`
`401`	No valid key (unauthorized), or a revoked one (revoked).	`unauthorized`, `revoked`
`403`	Your account can't use this endpoint now: invite, disabled, terms, no_plan, ended, unpaid or tool.	`no_plan`, `ended`, `unpaid`, `terms`, `disabled`, `invite`, `tool`
`429`	Your plan's minute or day limit is reached (minute, day).	`minute`, `day`
`500`	Something went wrong on bullpen.news (internal).	`internal`
`503`	The API is paused (off), busy (ceiling) or having trouble (unavailable). Retry-After comes with all but off.	`ceiling`, `off`, `unavailable`

Fresh: Up to a minute old.
History: Every firm with a published letter.
Cost: One call.