Campaigns

List founder campaigns

Changed on

Retrieves all fundraising campaigns for companies where the authenticated user is a founder. This endpoint returns comprehensive campaign data including funding progress, investor counts, and campaign status.

Use this endpoint to:

  • Build custom founder dashboards
  • Monitor fundraising progress across multiple campaigns
  • Generate reports on campaign performance
  • Integrate campaign data into your own tools

Only founders with the appropriate permissions can access this endpoint. The response includes both active and closed campaigns, with detailed metrics for each.

get/campaigns

Request

  • Base URL: https://api.wefunder.com
  • URL: https://api.wefunder.com/campaigns
  • Auth: OAuth 2 (authorization code, authorization URL https://wefunder.com/oauth/authorize, token URL https://api.wefunder.com/oauth/token; client credentials, token URL https://api.wefunder.com/oauth/token, scopes: read:offerings)

Query parameters

cursorinteger

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.

Response

Successful response

Example response

{
  "data": [
    {
      "id": 789,
      "type": "campaign",
      "attributes": {
        "state": "active",
        "company_id": 101,
        "company": "co_8Kd0aB3xQ9k2vF8mNp1zT5wY",
        "company_name": "My Startup Inc.",
        "company_url": "my-startup-inc",
        "created_at": "2023-01-10T09:00:00Z",
        "updated_at": "2023-03-15T14:30:00Z",
        "closed_at": "2023-06-30T23:59:59Z",
        "amount_raised": 25000,
        "investor_count": 42
      }
    }
  ],
  "meta": {
    "page_count": 25,
    "has_more": true
  }
}

Changes

  • f7ce1e834ec5Revision changes
    • warning

      removed the optional property / from the response with the status

    • info

      added the optional property / to the response with the status

  • b13c74d0be35Revision changes
    • breaking

      response property meta/next_cursor list-of-types was widened by adding types string to media type application/json of response 200

    • info

      added the optional property /// to the response with the status

    • info

      response property data/items/attributes/company_id deprecated