Sign in
Investment Delta

Bootstrap or page investment changes for a company

Changed on

The Investment Delta API: keep a copy of a company's investment records in sync by polling. Call without cursor to bootstrap (list every current record for the company); every response carries meta.next_cursor; call again with that cursor to receive only the records whose published state changed since. Records are the same shape in both modes.

  • Records are published state, not live rows: Wefunder publishes a record when the investment's founder-visible state changes, and serves exactly what was published.
  • visible: false records are tombstones: the investment is no longer visible to the company (canceled, converted to another round, hidden, or deleted). Delete your copy.
  • Apply records in cursor order. observed_at is when the payload was observed, not a version; a record you read late carries the current published state.
  • 410 Gone means your cursor predates the 90-day retention window. Bootstrap again and replace your dataset for the company from the result (records absent from the bootstrap are deleted).
  • Investor identity fields (investor.name, investor.legal_name, investor.email, investor.address, investor.bio, message, external_username) are omitted unless the token carries read:investors:pii.
  • Money is integer minor units plus amounts.currency (committed_cents, investment_size_cents, in_escrow_cents, contracts[].override_amount_cents). shares and average_share_price are decimal strings, null on rounds without shares. amounts.raised_cents is the row's contribution to the public raised figure (0 while needs_whitelisting); sum it, not committed_cents, to match the deal page.
get/companies/{company_id}/investments/changes

Request

  • Base URL: https://api.wefunder.com
  • URL: https://api.wefunder.com/companies/{company_id}/investments/changes
  • Auth: one of:
    • 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:investments)
    • 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:companies)

Path parameters

company_idstring required

The company's external id (co_…).

Query parameters

cursorstring

Opaque cursor from a previous response's meta.next_cursor. Omit to bootstrap.

per_pageinteger

Records per page, 1–100 (default 25). Delta pages count distinct investments.

Response

A page of records.

Example response

{
  "data": [
    {
      "amounts": {
        "currency": "usd"
      },
      "shares": "295",
      "average_share_price": "3.38"
    }
  ]
}

Changes