List or search people

GET

https://api.aventure.vc/v1/people

GET

/v1/people

$ curl -G https://api.aventure.vc/v1/people \
>      -H "X-Client-Secret: <apiKey>" \
>      -d includePrivate=false \
>      -d letter=A \
>      -d search=AI

1 {
2   "content": [
3     {
4       "id": "string",
5       "image": {
6         "isMonogram": true,
7         "picture": "string"
8       },
9       "nameAlias": [
10         {
11           "name": "Bun",
12           "displayable": true,
13           "type": "nickname"
14         }
15       ],
16       "nameFull": "string",
17       "slug": "aventure-vc",
18       "source": {
19         "changedAt": "2024-01-15T09:30:00Z",
20         "dataSourceUpdatedAt": "2024-01-15T09:30:00Z",
21         "detail": "string",
22         "kind": "string",
23         "pendingApproval": 1,
24         "sourceId": "string",
25         "status": "string"
26       },
27       "text": {
28         "expanded": "Canonical expanded summary for grouped text assertions.",
29         "generatedDescription": "Acme AI builds AI copilots for growth teams.",
30         "short": "Canonical short summary"
31       },
32       "createdAt": "2024-01-15T09:30:00Z",
33       "gender": "string",
34       "lastModifiedAt": "2024-01-15T09:30:00Z",
35       "nameFirst": "string",
36       "nameLast": "string",
37       "nameMiddle": "string",
38       "nickname": "string",
39       "publicId": "pV1StGXR8Z5ab",
40       "semanticMatch": {
41         "computedAt": "2024-01-15T09:30:00Z",
42         "cosineDistance": 1.1,
43         "cosineScore": 1.1,
44         "modelVersion": "string",
45         "rank": 1,
46         "sourceHash": "string",
47         "sourceId": "string",
48         "sourceJson": "string",
49         "sourceText": "string",
50         "sourceType": "entity"
51       },
52       "suffix": "string",
53       "updatedAt": "2024-01-15T09:30:00Z"
54     }
55   ],
56   "empty": true,
57   "first": true,
58   "last": true,
59   "number": 1,
60   "numberOfElements": 1,
61   "pageable": {
62     "offset": 1,
63     "pageNumber": 1,
64     "pageSize": 1,
65     "paged": true,
66     "sort": {
67       "empty": true,
68       "sorted": true,
69       "unsorted": true
70     },
71     "unpaged": true
72   },
73   "size": 1,
74   "sort": {
75     "empty": true,
76     "sorted": true,
77     "unsorted": true
78   },
79   "totalElements": 1,
80   "totalPages": 1
81 }

USE FOR: Browsing and filtering person/people/individual records in the people domain. semanticQuery uses the live priority embeddings tier and returns semanticMatch evidence. NOT FOR: Pre-create or pre-update identity gates; use /v1/people/duplicate-check.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

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.

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.

semanticQuerystringOptional

Semantic person search phrase.

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.

includePrivatebooleanOptional

Privileged read scope for admin callers. Bypasses the public visibility filter so hidden, unverified, and not-yet-published records are returned instead of being silently dropped. Defaults to private for admin API key or ROLE_ADMIN callers; client-secret/client-read callers stay public.

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

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error