Get a public offering

GET 
/offerings/:external_id

Retrieves a single offering by its id (ofr_...).

With read:public, a valid id for a non-public offering (e.g. a private Reg D 506(b) round) returns 404 — having an id does not make an offering publicly resolvable. With read:explore on a user access token, the offering resolves if that user may see it on wefunder.com (e.g. an accredited-only or invited round), and the response gains publicly_visible and invested. A token minted from an app's install on a company (an install granted read:companies) resolves that company's own rounds as the company does on its own deal page, private rounds included, with no read:explore; every other company's private round stays a 404 for it.

Request

Responses

200

Successful response

401

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.

404

The requested resource does not exist or is not visible to this token.

429

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

X-RateLimit-Limit

Request limit per hour

X-RateLimit-Remaining

Remaining requests

X-RateLimit-Reset

UTC timestamp when the limit resets