Ventures

/v1/ventures

Returns an array of compact venture objects including title, pitch text, country and map coordinates (latitude and longitude). Default record offset and limits apply.

Parameters

  • limit - refers to the number of records returned in the request.

  • offset - refers to the record offset, for pagination purposes.

Note

  • limit is optional (defaults to 20).
  • offset is optional (defaults to 0).

Return Values

  • id - the unique identifier for the venture.
  • ownerid - the unique identifier for the venture owner.
  • title - the corresponding name for the venture.
  • date_created - the date/time the venture was created.
  • date_founded - the date the venture was founded.
  • pitch - the corresponding pitch for the venture.
  • tagline - the short description of the venture.
  • logo_uri - the URI corresponding to the venture logo in JPEG format.
  • website - the URI corresponding to the venture website.
  • network_strength - a decimal value corresponding to the calculated network strength of the venture.
  • shorturl - the short URL which redirects to the full URI of the venture.
  • address - the physical address for the venture's base of operations.
  • country - the primary country where the venture is based.
  • latitude - the north-south distance from the equator, expressed in degrees and minutes.
  • longitude - the east-west distance from the meridian, expressed in degrees and minutes.

Example Request

API Address: https://api.vc4a.com
GET /v1/ventures.json?offset=0&limit=5

Example Response

{
    "ventures": [{
        "id": "9",
        "ownerid": "13",
        "title": "Miniature Africa",
        "date_created": "2015-04-15 10:51:26",
        "date_founded": "2014-03-01",
        "pitch": "We are a digitial photo/video processing service using the latest tiltshift technology.",
        "tagline": "Your world in miniature.",
        "logo_uri": "https://s3.amazonaws.com/vc4africa/wblob/542197FD2D7132/cgHjjtolHDHza3-BxI-RTA/avatar.jpg",
        "website": "https://tiltshift.me",
        "network_strength": "0.74",
        "shorturl": "http://vc4afri.ca/cl8j4",
        "address": "Chad St, Addis Ababa",
        "country": "Ethiopia",
        "latitude": "9.011821",
        "longitude": "38.732884"
    }, {
        "id": "12",
        "ownerid": "22",
        "title": "Panda Whale",
        "date_created": "2015-04-14 11:31:53",
        "date_founded": "2012-12-05",
        "pitch": "We are a consumer Internet service for organizing and sharing great content.",
        "tagline": "Discover and share the best content.",
        "logo_uri": "https://s3.amazonaws.com/vc4africa/wblob/542197FD2D7132/gnplmIktgODmX5XLWYeAew/avatar.jpg",
        "website": "https://pandawhale.co.ke",
        "network_strength": "0.81",
        "shorturl": "http://vc4afri.ca/7cqso",
        "address": "1436 Sanusi Fafunwa St, Lagos",
        "country": "Nigeria",
        "latitude": "6.430777",
        "longitude": "3.427831"
    }, {
        "id": "13",
        "ownerid": "19",
        "title": "Mino Monsters",
        "date_created": "2015-04-13 10:25:49",
        "date_founded": "2010-05-01",
        "pitch": "Discover which of your friends are voters and campaign with them to elect Pokemon.",
        "tagline": "Innovating the Pokemon election space.",
        "logo_uri": "https://s3.amazonaws.com/vc4africa/wblob/542197FD2D7132/PlNf3lHDjnHz1m8lMMbVwQ/avatar.jpg",
        "website": "http://www.minomonsters.com/",
        "network_strength": "0.83",
        "shorturl": "http://vc4afri.ca/ogrgq",
        "address": "18 Ave Churchill, Yaounde",
        "country": "Cameroon",
        "latitude": "3.875808",
        "longitude": "11.518068"
    }, {
        "id": "16",
        "ownerid": "44",
        "title": "Anvil Studio",
        "date_created": "2015-04-12 15:43:03",
        "date_founded": "2006-04-30",
        "pitch": "Maker of the finest widgets to simplify your modern life.",
        "tagline": "Widgets 'R' Us",
        "logo_uri": "https://s3.amazonaws.com/vc4africa/wblob/542197FD2D7132/2akmj5tSx2Fxb1sGDPgm4Q/avatar.jpg",
        "website": "https://anvilstudio.co",
        "network_strength": "0.65",
        "shorturl": "http://vc4afri.ca/7xxmk",
        "address": "4th Parklands Avenue, Nairobi",
        "country": "Kenya",
        "latitude": "-1.257095",
        "longitude": "36.817868"
    }, {
        "id": "18",
        "ownerid": "30",
        "title": "SpaceX",
        "date_created": "2015-04-12 09:07:29",
        "date_founded": "2009-06-20",
        "pitch": "We are an aerospace manufacturer and space transport services company.",
        "tagline": "Design, manufacture and launche advanced spacecraft.",
        "logo_uri": "https://s3.amazonaws.com/vc4africa/wblob/542197FD2D7132/A8Zqor1ajDp3OW1f0WQRFw/avatar.jpg",
        "website": "https://spacex.com",
        "network_strength": "0.91",
        "shorturl": "http://vc4afri.ca/zp4j2",
        "address": "1 Rocket Rd, Hawthorne CA",
        "country": "United States",
        "latitude": "33.920587",
        "longitude": "-118.327140"
    }],
    "_metadata": [{
        "offset": "0",
        "limit": "5",
        "totalCount": 5
    }],
  "status_code": 200,
  "status_txt": "OK"
}

/v1/ventures/:venture_id

Returns detailed information and metadata for a given venture, including followers, summary plan text, fundraising status, sectors, tags, venture owner ID and so on.

Parameters

  • venture_id - the unique vc4a identifier for the venture.

Note

  • venture_id is required.

Return Values

  • id - the unique identifier for the venture.
  • ownerid - the unique identifier for the venture owner.
  • title - the corresponding title for the venture.
  • pitch - the corresponding textual pitch for the venture.
  • tagline - the short description of the venture.
  • logo_uri - the URI corresponding to the venture logo in JPEG format.
  • website - the URI corresponding to the venture website.
  • video_pitch - the URI corresponding to the venture's video pitch (YouTube, Vimeo, etc.).
  • date_created - the date/time the venture was created.
  • date_founded - the date the venture was founded.
  • tags - an array of tags associated with the venture. (Deprecated)
  • fundStatus - the current fundraising status of the venture.
  • address - the physical address for the venture's base of operations.
  • country - the primary country where the venture is based.
  • network_strength - a decimal value corresponding to the calculated network strength of the venture.
  • shorturl - the short URL which redirects to the full URI of the venture.
  • latitude - the north-south distance from the equator, expressed in degrees and minutes.
  • longitude - the east-west distance from the meridian, expressed in degrees and minutes.
  • pitch_type - a string value corresponding to the type of pitch (elevator, longer, complex).
  • risky - a boolean value; high-risk venture that offers potentially high-rewards.
  • nda - a boolean value; venture owner requires NDA before sharing business plan.
  • ambitious - a boolean value; founder has the business savvy and persistence.
  • network - a boolean value; venture team is able to get introduced to the right people.
  • build - a string value corresponding to how the product/service is built (internal or external).
  • team - the summary text describing the venture team members.
  • state - a string value corresponding to the current state of the venture (none, prototype, working).
  • ip - a boolean value; venture team owns the intellectual property for the product.
  • oss - a boolean value; the product/service is based on open source technology.
  • product - the summary text corresponding to the product description.
  • community - a boolean value; plan to start by building a community of passionate customers.
  • advertising - a boolean value; have identified one or more revenue streams.
  • prognosis - a boolean value; have a cash-flow prognosis.
  • revenue - a string value corresponding to the basic revenue plan (soon or now).
  • revenue_plan - the summary text corresponding to the revenue plan text.
  • notes - supplementary notes as added by the VC4A team.
  • quickscan_last_updated - date/time stamp corresponding to the last time the QuickScan was updated.
  • address - the cooresponding street address where the venture is based.
  • sectors - an array of sectors the venture is engaged in.
  • interest_regions - an array of regions the ventures is focused on.
  • interest_countries - an array of countries the ventures is focused on.
  • followers - an array of unique identifiers for the users who are following the venture.

Example Request

API Address: https://api.vc4a.com
GET /v1/ventures/18.json

Example Response

{
    "id": "18",
    "ownerid": "30",
    "title": "SpaceX",
    "pitch": "We are an aerospace manufacturer and space transport services company.",
    "tagline": "Design, manufacture and launche advanced spacecraft.",
    "logo_uri": "https://s3.amazonaws.com/vc4africa/wblob/542197FD2D7132/A8Zqor1ajDp3OW1f0WQRFw/avatar.jpg",
    "website": "https://spacex.com",
    "video_pitch": "https://youtu.be/BhMSzC1crr0",
    "date_created": "2016-07-21 23:18:03",
    "date_founded": "2002-03-01",
    "fundStatus": "Seeking Investor",
    "network_strength": "0.91",
    "shorturl": "http://vc4afri.ca/zp4j2",
    "address": "1 Rocket Rd, Hawthorne CA",
    "country": "United States",
    "latitude": "33.920587",
    "longitude": "-118.327140"
    "pitch_type: "elevator",
    "risky": true,
    "nda": false,
    "ambitious": true,
    "network": true,
    "build": "internal",
    "team": "We're a bunch of rocket scientists.",
    "state": "working",
    "ip": true,
    "oss": false,
    "product": "We have developed a medium-lift rocket and a crew capsule.",
    "community": true,
    "advertising": true,
    "prognosis": true,
    "revenue": "now",
    "revenue_plan": "We are a profit-making business in a niche market.",
    "notes": null,
    "quickscan_last_updated": "2016-09-10 05:51:47",
    "sectors": [{
        "Aerospace",
        "Engineering",
        "Manufacturing",
    }],
    "interest_regions": [{
        "East Africa",
        "North America",
        "Western Europe",
        "Low Earth Orbit",
        "Mars",
        "Deep Space"
    }],
    "interest_countries": [{
        "Kenya",
        "Botswana",
        "Ghana",
        "United States"
    }],
    "followers": [{
        "userid": "4613",
        {
        "userid": "34892"
        },
        {
        "userid": "13"
        },
        {
        "userid": "13802"
        },
        {
        "userid": "4769"
        },
        {
        "userid": "16838"
        },
    }]
},
  "status_code": 200,
  "status_txt": "OK"
}

/v1/ventures/:venture_id/activity

Returns the activity of a given venture.

Parameters

  • venture_id - the unique vc4a identifier for the venture.

Note

  • venture_id is required.

Return Values

  • id - the unique vc4a identifier for the venture activity item.
  • date - a timestamp representing the time at which the activity was created.
  • action - the recorded action of the activity item, including a URI to the profile of the actor.
  • content - (optional) the textual content of the activity update for the venture.
  • metadata - offset, limit and totalCount.

Example Request:

API Address: https://api.vc4a.com
GET /v1/ventures/18/activity.json

Example Response:

{
    "venture_activity": [{
        "id": "150596",
        "date": "2016-09-05 15:32:23",
        "action": "Paul created the venture GreenGlow Stoves.",
        "content": ""
        },
        {
        id: "123780",
        date: "2016-07-21 21:22:27",
        action: "GreenGlow Stoves has added a round to their funding history.",
        content: ""
        },
        {
        id: "123782",
        date: "2016-07-21 21:38:37",
        action: "The venture GreenGlow Stoves has added the QuickScan details.",
        content: ""
    }],
    "_metadata": [{
        "offset": "0",
        "limit": "20",
        "totalCount": 2
    }]
  },
  "status_code": 200,
  "status_txt": "OK"
}

/v1/ventures/:venture_id/team

Returns a list of IDs, names and titles for the team member(s) associated with a given venture.

Parameters

  • venture_id - the unique vc4a identifier for the venture.

Note

  • venture_id is required.

Example Request:

API Address: https://api.vc4a.com
GET /v1/ventures/18/team.json

Return Values

  • team_members: an array of unique identifiers corresponding to the team members.
  • metadata - offset, limit and totalCount.

Example Response:

{
    "team_members": [{
        userid: "14320",
        fullname: "Mark Mwaura",
        title: "CEO"
        },
        {
        userid: "14400",
        fullname: "Muigai Mwaura",
        title: "Technical Lead"
        },
        {
        userid: "17575",
        fullname: "Joseph Karanja",
        title: "Co-Founder and Business Lead"
    }],
    "_metadata": [{
        "offset": "0",
        "limit": "20",
        "totalCount": 3
    }]
}

/v1/ventures/countries

Returns an array of base countries.

Parameters

  • None.

Note

  • These values are useful as parameters for searching ventures by country. Refer to /v1/ventures/search.

Return Values

  • countries - an array of string values corresponding to venture base countries, in alpha ascending order.
  • metadata - totalCount.

Example Request:

API Address: https://api.vc4a.com
GET /v1/ventures/countries.json

Example Response:

{
    "countries": [{
        "Algeria",
        "Angola",
        "Benin",
        "Botswana",
        "Burkina Faso",
        "Burundi",
        "Cameroon",
        "Cape Verde",
        "Central African Rep",
        "Chad",
        "Congo",
        "Dem. Rep. Congo",
        "Djibouti",
        "Egypt",
        "Ethiopia",
        ...
        }]
    }],
    "_metadata": [{
        "totalCount": 47
    }]
}

/v1/ventures/sectors

Returns an array of business sectors.

Parameters

  • None.

Note

  • The sector value may be used as a parameter for searching fundraising rounds. Refer to /v1/fundraising/search.

Return Values

  • sectors - an array of string values corresponding to venture sector names, in alpha ascending order.
  • metadata - totalCount.

Example Request:

API Address: https://api.vc4a.com
GET /v1/ventures/sectors.json

Example Response:

{
    "sectors": [{
        "3D printing",
        "Accounting services",
        "Adtech",
        "Agribusiness",
        "Agrichemicals",
        "Agritech",
        "Animal farming",
        "Animation",
        "Artificial intelligence",
        "Arts",
        "Automotive",
        "Banking",
        "Big data",
        "Biofuels",
        "Biomass",
        "Biotechnology and medical research",
        "Blockchain",
        "Business services",
        "Cars",
        "Clean technology",
        "Clean technology and energy",
        ...
        }]
    }],
    "_metadata": [{
        "totalCount": 123
    }]
}