Wefunder Investments API
The Investments API from Wefunder — 1 operation(s) for investments.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/wefunder-investments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Wefunder API v2 Activity Investments API
description: 'OAuth 2.0 API for accessing Wefunder data programmatically.
## Authentication
This API uses OAuth 2.0 for authentication. To get started:
1. Create an OAuth application at `/oauth/applications`
2. Get your Client ID and Client Secret
3. Implement the OAuth 2.0 Authorization Code flow
4. Use the access token to make API requests
## Rate Limits
- Standard API: 1,000 requests/hour per token
- Admin API: 10,000 requests/hour per token
## Base URL
All API requests should be made to: `https://api.wefunder.com/api/v2`
'
version: '2.0'
contact:
name: Wefunder API Support
email: api@wefunder.com
servers:
- url: https://{environment}.wefunder.com/api/v2
variables:
environment:
default: api
enum:
- api
- staging
tags:
- name: Investments
paths:
/investments:
get:
tags:
- Investments
summary: List user investments
description: 'Retrieves a paginated list of all investments made by the authenticated user. Each investment
includes details about the amount invested, the company, investment date, and current status.
Use this endpoint to:
- Display a user''s investment portfolio
- Track investment history and performance
- Build custom reporting and analytics
The list is ordered by investment date (newest first) and supports cursor-based pagination
for efficient iteration through large portfolios. Each investment object includes the
campaign details and current valuation information.
'
operationId: listInvestments
security:
- bearerAuth:
- read:investments
parameters:
- $ref: '#/components/parameters/cursor'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/InvestmentListEnvelope'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimitExceeded'
components:
parameters:
cursor:
name: cursor
in: query
description: 'Cursor-based pagination token. Use the `next_cursor` value from the previous response''s
`meta` object to retrieve the next page of results. Omit this parameter to retrieve the
first page.
'
schema:
type: integer
example: 12345
schemas:
PaginationMeta:
type: object
properties:
count:
type: integer
example: 25
has_more:
type: boolean
example: true
next_cursor:
type:
- integer
- 'null'
example: 12345
InvestmentListEnvelope:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Investment'
meta:
$ref: '#/components/schemas/PaginationMeta'
Error:
type: object
properties:
error:
type: object
properties:
type:
type: string
example: unauthorized
message:
type: string
example: Invalid or expired token
details:
type: object
additionalProperties: true
request_id:
type: string
description: Unique identifier for this request. Quote it in support tickets.
example: req_abc123
remediation:
type: string
description: When present, a hint on how to resolve the error.
example: Obtain a new access token using the OAuth 2.0 flow.
Investment:
type: object
properties:
id:
type: integer
example: 456
type:
type: string
example: investment
attributes:
type: object
properties:
amount:
type: number
format: float
example: 1000
state:
type: string
example: confirmed
confirmed_at:
type:
- string
- 'null'
format: date-time
example: '2023-03-15T12:00:00Z'
created_at:
type: string
format: date-time
example: '2023-03-10T10:30:00Z'
updated_at:
type: string
format: date-time
example: '2023-03-15T12:00:00Z'
fundraise_id:
type: integer
example: 789
campaign:
type:
- object
- 'null'
properties:
id:
type: integer
example: 789
company_name:
type: string
example: My Startup Inc.
company_id:
type: integer
example: 101
responses:
RateLimitExceeded:
description: '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.
'
headers:
X-RateLimit-Limit:
schema:
type: integer
description: Request limit per hour
X-RateLimit-Remaining:
schema:
type: integer
description: Remaining requests
X-RateLimit-Reset:
schema:
type: integer
description: UTC timestamp when the limit resets
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: '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.
'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: oauth2
description: OAuth 2.0 authorization with access tokens
flows:
authorizationCode:
authorizationUrl: https://wefunder.com/oauth/authorize
tokenUrl: https://wefunder.com/oauth/token
scopes:
read:public: Read public deal data (explore offerings); requires no user context
read:profile: Read user profile information
read:investments: Read user investment data
read:campaigns: Read campaign information for companies you founded
read:attribution:aggregate: Read aggregate attribution statistics (Tier 0)
read:attribution:anonymized: Read anonymized attribution data (Tier 1 - requires approval)
read:attribution:full: Read full attribution data with investor PII (Tier 2 - founders only)
admin:attribution: Administrative access to attribution system (Tier 3 - Wefunder admins only)
read:syndicates: View syndicates, members, deals, and portfolio
write:syndicates: Manage members, update settings, operate on deals
read:spvs: View partner SPVs, their invites, sessions, and investments
write:spvs: Create and manage partner SPVs, invites, and investment sessions
read:webhooks: View webhook subscriptions
write:webhooks: Create, update, and delete webhook subscriptions
clientCredentials:
tokenUrl: https://wefunder.com/oauth/token
scopes:
read:public: Read public deal data. The only scope a server-side (client_credentials) key may hold — it acts as the app, with no user, so it can never read user-scoped data.