Person

 

Use the persons node to get information about persons.
A limit on the number of objects to be returned, between 1 and 100.

Retrieving Persons

GET https://vcapi.parsers.me/v2/persons/
Authorization: Bearer {your-auth-token} or query string parameter

Success responce:

Status 200 OK

[
    {
        "Id": "9cac4e05-2815-4bbf-b165-0007bf0f09e0",
        "FirstName": null,
        "LastName": null
    },
...
    {
        "Id": "a5e2ca7b-3c73-4b09-a9f0-000ecfb79b1d",
        "FirstName": "Ron",
        "LastName": "Czerny"
    }
]

The data response payload contains the array of persons.

Retrieving Basic Person Information

Basic Fund properties

Id Person Fund Id
FirstName Person First Name
LastName Person Last Name 
GET https://vcapi.parsers.me/v2/persons/{personId}
Authorization: Bearer {your-auth-token} or query string parameter

Success responce:

Status 200 OK

{
    "Id": "9cac4e05-2815-4bbf-b165-0007bf0f09e0",
    "FirstName": null,
    "LastName": null
}

The data response payload contains specific fund.

Retrieving Advanced Person Information

When you query a persons it returns a set of basic fields by default, as the examples above show. However, you can specify which fields you want returned by using the select parameter and listing each field. This overrides the defaults and returns the fields you specify, and the Id of the object, which is always returned.

Advanced Fund properties

Id Person Fund Id
FirstName Person First Name
LastName Person Last Name
Location Person current locations
RelatedLocations Locations related to Person in any way
Twitter An array of Twitter pages collected from various sources
Facebook An array of Facebook pages collected from various sources
LinkedIn An array of LinkedIn pages collected from various sources
Email An array of Emails collected from various sources 
GET https://vcapi.parsers.me/v2/persons/{personId}/?$select=FirstName,LastName,Location,RelatedLocations,Twitter,Facebook,LinkedIn,Email
Authorization: Bearer {your-auth-token} or query string parameter

Success responce:

Status 200 OK

{
    "Id": "eb4fbc25-c42f-4a77-a2d8-000f527ff043",
    "FirstName": "Betsy",
    "LastName": "Goodrich",
    "Location": "United States, Massachusetts, Cambridge",
    "LinkedIn": [
        "https://www.linkedin.com/in/betsygoodrich"
    ],
    "Twitter": null,
    "Facebook": null,
    "Email": null,
    "RelatedLocations": [
        "United States, Massachusetts, Cambridge"
    ]
}

The data response payload contains specific person.
This parameters can be used with collections and specific records.

Retrieving Person Experiences

Person Experiences

Id Experience Id
DateStart DateStart
DateEnd DateEnd
Title Title
Location Location

Retrieving Person with experiences

GET https://vcapi.parsers.me/v2/persons/{personId}/?$expand=Experiences
Authorization: Bearer {your-auth-token} or query string parameter

Success responce:

Status 200 OK

{
    "Id": "eb4fbc25-c42f-4a77-a2d8-000f527ff043",
    "FirstName": "Betsy",
    "LastName": "Goodrich",
    "Experiences": [
        {
            "Id": "ec6552f2-61a1-4df2-a203-e461bc330212",
            "DateStart": "1995-07-01T00:00:00",
            "DateEnd": null,
            "Title": "VP Design & Co-founder",
            "Location": null
        }
    ]
}

Retrieving Person experiences with positions

Reference properties

Position Person Position
Level Person Position Level 
GET https://vcapi.parsers.me/v2/persons/{personId}/?$expand=Experiences,Experiences.Positions
Authorization: Bearer {your-auth-token} or query string parameter

Success responce:

Status 200 OK

{
    "Id": "eb4fbc25-c42f-4a77-a2d8-000f527ff043",
    "FirstName": "Betsy",
    "LastName": "Goodrich",
    "Experiences": [
        {
            "Id": "ec6552f2-61a1-4df2-a203-e461bc330212",
            "DateStart": "1995-07-01T00:00:00",
            "DateEnd": null,
            "Title": "VP Design & Co-founder",
            "Location": null,
            "Positions": [
                {
                    "Position": "Vice President",
                    "Level": "Vice"
                },
                {
                    "Position": "Founder",
                    "Level": null
                }
            ]
        }
    ]
}

Retrieving Person experiences with company

Reference properties

Id Company Id
Type Company type (Startup, Fund) 
GET https://vcapi.parsers.me/v2/persons/{personId}/?$expand=Experiences,Experiences.Company
Authorization: Bearer {your-auth-token} or query string parameter

Success responce:

Status 200 OK

{
    "Id": "bb469e3d-dfd7-40bf-8b84-0012cdb2f7e4",
    "FirstName": null,
    "LastName": null,
    "Experiences": [
...
        {
            "Id": "fa21e128-99f5-4053-93d2-51ef41a244c4",
            "DateStart": "2013-04-01T00:00:00",
            "DateEnd": "2016-03-01T00:00:00",
            "Title": "Royalty Auditor / Business Management",
            "Location": "Liberia, Montserrado",
            "Company": {
                "Id": "e2a056bc-ec2a-4bcf-830a-6b4829d985d1",
                "Type": "Startup"
            }
        },
...
    ]
}