List People | aVenture Developer Docs

{
  "content": [
    {
      "id": "string",
      "image": {
        "isMonogram": true,
        "picture": "string"
      },
      "nameAlias": [
        {
          "name": "Bun",
          "displayable": true,
          "type": "nickname"
        }
      ],
      "nameFull": "string",
      "slug": "aventure-vc",
      "text": {
        "expanded": "Canonical expanded summary for grouped text assertions.",
        "generatedDescription": "Acme AI builds AI copilots for growth teams.",
        "short": "Canonical short summary"
      },
      "bioUpdatedAt": "2024-01-15T09:30:00Z",
      "createdAt": "2024-01-15T09:30:00Z",
      "gender": "string",
      "lastModifiedAt": "2024-01-15T09:30:00Z",
      "nameFirst": "string",
      "nameLast": "string",
      "nameMiddle": "string",
      "nickname": "string",
      "publicId": "pV1StGXR8Z5ab",
      "semanticMatch": {
        "computedAt": "2024-01-15T09:30:00Z",
        "cosineDistance": 1.1,
        "cosineScore": 1.1,
        "modelVersion": "string",
        "rank": 1,
        "sourceHash": "string",
        "sourceId": "string",
        "sourceType": "string"
      },
      "suffix": "string",
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

List people with the same filters and sort as POST /v1/people/search, passed as query parameters. Use the POST search for semantic ranking or a JSON body, and POST /v1/search/natural/people for plain English.

Query parameters

firstNamestringOptional

Person first name.

lastNamestringOptional

Person last name.

statusstringOptional

Person workflow status.

arrayFilter.entityNamelist of stringsOptional

Associated entity names.

arrayFilter.typeRecordlist of enumsOptional

Associated entity type scope. Omit or use [] for any associated type.

arrayFilter.personTitlelist of stringsOptional

Person titles.

arrayFilter.investedCompanylist of stringsOptional

Invested company names.

arrayFilter.roundlist of stringsOptional

Fundraise round labels.

arrayFilter.amountRaisedRangelist of objectsOptional

Selected per-investment amount-raised ranges (inclusive decimal bounds, USD) used to filter people by investment activity. Body syntax is [{“min”:220000,“max”:5000000}] with plain JSON numbers only.

arrayFilter.amountInvestedRangelist of objectsOptional

Selected investor-level amount-invested ranges (inclusive decimal bounds) used to filter people by attributed investment activity. Body syntax is {“arrayFilter”:{“amountInvestedRange”:[{“min”:220000,“max”:5000000}]}} with plain JSON numbers in each fundraise transaction currency. Do not send currency signs, codes, commas, numeric strings, or abbreviated values.

arrayFilter.totalInvestmentCountlist of objectsOptional

Selected total-investment-count ranges (inclusive integer bounds) used to filter people by the number of distinct fundraise deals they invested in.

searchstringOptional

Search keyword or phrase. Single characters valid; stop words rejected.

personNamelist of stringsOptional

Exact normalized match against a person's full name or slug.

personIdlist of stringsOptional

Restrict results to specific person IDs. Omit or use [] for no ID restriction.

letterstringOptional

First-name initial.

entityIdstringOptionalformat: "uuid"

Associated entity UUID.

entitySlugstringOptional

Associated entity slug.

rolestringOptional

Associated entity role or title.

isCurrentbooleanOptional

Filter current associations.

includeUrlbooleanOptional

Include URL links on each person

includeAddressbooleanOptional

Include addresses on each person

investorActivity.totalInvestmentRangelist of objectsOptional

Distinct fundraise-deal count ranges for an investor, with inclusive integer bounds.

investorActivity.totalAmountInvestedUsdRangelist of objectsOptional

Total USD amount-invested ranges with inclusive bounds.

investorActivity.averageAmountInvestedUsdRangelist of objectsOptional

Average USD amount-invested ranges with inclusive bounds.

investorActivity.largestAmountInvestedUsdRangelist of objectsOptional

Largest USD amount-invested ranges with inclusive bounds.

investorActivity.smallestAmountInvestedUsdRangelist of objectsOptional

Smallest USD amount-invested ranges with inclusive bounds.

countOnlybooleanOptional

When true, return only the page total in the body and skip the content payload.

hasImageFirstbooleanOptional

When true, sort people who have a photo before those who do not.

permitMonogrambooleanOptional

When false, monogram fallback logos are stripped from the response. Defaults to true.

pageintegerOptional>=0Defaults to 0

Zero-based page index (0..N)

sizeintegerOptional>=1Defaults to 25

The size of the page to be returned

sortlist of stringsOptional

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error