Get a company's pitch
GET/companies/:id/pitch
The Overview tab's pitch as structured data: the story as ordered blocks (heading,
paragraph, list, image, video, footnote), plus the perk tiers of the round the page
shows the viewer. Images and embedded videos keep their place in the document with an absolute
URL, because founders publish perk tiers, stretch goals, timelines, and charts as pictures
(typically with no alt text) and a plain-text rendering would drop them.
What is parsed is what the page renders: the story passes through the site's own sanitizer
first, so an embed the page refuses (a host off its allowlist, a javascript: URL) is never
served here either. Same "who has a page" rule and round chooser as GET /companies/{id}.
A site-public company with no round the viewer may see still has a pitch (perks: null).
perks.described_in_pitch is a heuristic: true when the structured perk list is a placeholder
("See investor overview page", or one identical sentence on every tier) and the real tiers are
in the story's images.
authored_by says who wrote the story: company (the issuer's own words and imagery, not a
Wefunder assessment) or wefunder (a Wefunder-prepared deal memo the company did not
participate in; disclaimer carries the page's notice). A pitch can run to ~70 KB; use
sections to ask for less.
Request
Responses
- 200
- 400
- 401
- 404
- 429
Successful response
sections names a section that does not exist.
Authentication required or token is invalid/expired. This error occurs when:
- No Authorization header is provided
- The access token is invalid or malformed
- The access token has expired
- The access token has been revoked
To resolve: Obtain a new access token using the OAuth 2.0 flow.
Unknown or hidden company.
Too many requests in a short time period. The API enforces rate limits to ensure fair usage and system stability. When you exceed the limit, you'll receive this error along with headers indicating when you can retry.
Check the X-RateLimit-Reset header to know when your limit will reset.
Consider implementing exponential backoff in your application.
Response Headers
Request limit per hour
Remaining requests
UTC timestamp when the limit resets