Sign in
Syndicate Portfolio

List syndicate portfolio positions

Changed on

Returns the syndicate's portfolio one deal at a time, newest first. Each position is one fundraise ("offering"), aggregated across everyone holding its securities, with investor_count at both the position and security level.

securities breaks each position down by security offering (for example, an early bird tier vs the regular terms) — most deals have a single entry. Fund and SPV deals identify the companies the vehicle invested in under holdings; some older vehicles have no recorded holdings and return an empty array.

get/syndicates/{syndicate_id}/portfolio/positions

Request

  • Base URL: https://api.wefunder.com
  • URL: https://api.wefunder.com/syndicates/{syndicate_id}/portfolio/positions
  • 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:syndicates)

Path parameters

syndicate_idstring required

The syndicate's id (syn_...).

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.

per_pageinteger

Page size, 1-100. Defaults to 25.

status'active' | 'exited' | 'sold' | 'failed'

Filter positions by status.

companystring

Filter to a single company by its id (co_...). Unknown ids return 404.

Response

Successful response

Example response

{
  "data": [
    {
      "id": "ofr_9aKxQ2vF8mNp1zT5wY7Qb3Cd",
      "attributes": {
        "offering_id": "ofr_9aKxQ2vF8mNp1zT5wY7Qb3Cd",
        "company": {
          "id": "co_2bt9eJn6X8C9gnShl63qlzkK",
          "name": "Acme Robotics",
          "slug": "acme-robotics"
        },
        "security": {
          "type": "safe",
          "label": "SAFE"
        },
        "currency": "usd",
        "return_multiple": "1.6492",
        "securities": [
          {
            "security": {
              "type": "safe",
              "label": "SAFE"
            },
            "terms": {
              "share_price": "10.0"
            }
          }
        ],
        "holdings": [
          {
            "company": {
              "id": "co_2bt9eJn6X8C9gnShl63qlzkK",
              "name": "Acme Robotics",
              "slug": "acme-robotics"
            }
          }
        ]
      }
    }
  ]
}

Changes

  • b13c74d0be35Revision changes
    • warning

      removed the optional property ///// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • info

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

    • info

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

  • d5f3a557f40dRevision changes
    • info

      endpoint added