Look up people in bulk by id or slug

POST

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

POST

/v1/people/lookup/batch

curl -X POST https://api.aventure.vc/v1/people/lookup/batch \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "content": [
    {
      "association": [
        {
          "associationId": 1,
          "entityAddress": [
            {
              "address": 456,
              "addressLine1": "string",
              "addressLine2": "string",
              "association": [
                {
                  "id": 123,
                  "isCurrent": true,
                  "endDate": "2023-01-15",
                  "role": "domicile",
                  "startDate": "2023-01-15"
                }
              ],
              "city": {
                "name": "Boston",
                "id": 1
              },
              "country": {
                "name": "United States",
                "countryCodeChar2": "US",
                "countryCodeChar3": "USA",
                "id": 1,
                "unRegion": "string",
                "unSubregion": "string"
              },
              "countryAbbrev": "string",
              "createdAt": "2024-01-15T09:30:00Z",
              "fullAddress": "123 Main St, Boston, MA 02110, USA",
              "id": 123,
              "latitude": 1.1,
              "longitude": 1.1,
              "postalCode": "string",
              "state": {
                "name": "Massachusetts",
                "id": 1,
                "stateAbbrev": "MA"
              },
              "stateAbbrev": "string",
              "street": "string",
              "updatedAt": "2024-01-15T09:30:00Z",
              "isCurrent": true,
              "isHq": true,
              "isPrimary": true
            }
          ],
          "entityId": "string",
          "entityLogo": {
            "isMonogram": true,
            "logo": "string",
            "logoSquare": "string"
          },
          "entitySlug": "aventure-vc",
          "entityUrlLink": [
            {
              "url": "https://example.com",
              "urlType": "website",
              "crawlCdnProvider": "cloudflare",
              "crawlRenderMode": "static",
              "createdAt": "2024-01-15T09:30:00Z",
              "id": 1,
              "isCurrent": true,
              "isPrimary": true,
              "owner": {
                "entityId": "string",
                "personId": "string"
              },
              "sourceId": "string",
              "status": "string",
              "statusChecked": "2024-01-15T09:30:00Z",
              "updatedAt": "2024-01-15T09:30:00Z"
            }
          ],
          "personAddress": [
            {
              "address": 456,
              "addressLine1": "string",
              "addressLine2": "string",
              "association": [
                {
                  "id": 123,
                  "isCurrent": true,
                  "endDate": "2023-01-15",
                  "role": "domicile",
                  "startDate": "2023-01-15"
                }
              ],
              "city": {
                "name": "Boston",
                "id": 1
              },
              "country": {
                "name": "United States",
                "countryCodeChar2": "US",
                "countryCodeChar3": "USA",
                "id": 1,
                "unRegion": "string",
                "unSubregion": "string"
              },
              "countryAbbrev": "string",
              "createdAt": "2024-01-15T09:30:00Z",
              "fullAddress": "123 Main St, Boston, MA 02110, USA",
              "id": 123,
              "latitude": 1.1,
              "longitude": 1.1,
              "postalCode": "string",
              "state": {
                "name": "Massachusetts",
                "id": 1,
                "stateAbbrev": "MA"
              },
              "stateAbbrev": "string",
              "street": "string",
              "updatedAt": "2024-01-15T09:30:00Z",
              "isCurrent": true,
              "isHq": true,
              "isPrimary": true
            }
          ],
          "personId": "string",
          "personImage": {
            "isMonogram": true,
            "picture": "string"
          },
          "personName": "string",
          "personSlug": "aventure-vc",
          "personUrlLink": [
            {
              "url": "https://example.com",
              "urlType": "website",
              "crawlCdnProvider": "cloudflare",
              "crawlRenderMode": "static",
              "createdAt": "2024-01-15T09:30:00Z",
              "id": 1,
              "isCurrent": true,
              "isPrimary": true,
              "owner": {
                "entityId": "string",
                "personId": "string"
              },
              "sourceId": "string",
              "status": "string",
              "statusChecked": "2024-01-15T09:30:00Z",
              "updatedAt": "2024-01-15T09:30:00Z"
            }
          ],
          "endDate": "2024-01-15T09:30:00Z",
          "entityName": "string",
          "entityOperatingStatus": "string",
          "entityType": "Company",
          "isCurrent": true,
          "score": 1,
          "startDate": "2024-01-15T09:30:00Z",
          "titleFunction": "string",
          "titleId": 1,
          "titleLevel": "string",
          "titleName": "string"
        }
      ],
      "core": {
        "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"
        },
        "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",
          "sourceJson": "string",
          "sourceText": "string",
          "sourceType": "entity"
        },
        "suffix": "string",
        "updatedAt": "2024-01-15T09:30:00Z"
      },
      "enrichment": {
        "address": [
          {
            "address": 456,
            "addressLine1": "string",
            "addressLine2": "string",
            "association": [
              {
                "id": 123,
                "isCurrent": true,
                "endDate": "2023-01-15",
                "role": "domicile",
                "startDate": "2023-01-15"
              }
            ],
            "city": {
              "name": "Boston",
              "id": 1
            },
            "country": {
              "name": "United States",
              "countryCodeChar2": "US",
              "countryCodeChar3": "USA",
              "id": 1,
              "unRegion": "string",
              "unSubregion": "string"
            },
            "countryAbbrev": "string",
            "createdAt": "2024-01-15T09:30:00Z",
            "fullAddress": "123 Main St, Boston, MA 02110, USA",
            "id": 123,
            "latitude": 1.1,
            "longitude": 1.1,
            "postalCode": "string",
            "state": {
              "name": "Massachusetts",
              "id": 1,
              "stateAbbrev": "MA"
            },
            "stateAbbrev": "string",
            "street": "string",
            "updatedAt": "2024-01-15T09:30:00Z",
            "isCurrent": true,
            "isHq": true,
            "isPrimary": true
          }
        ],
        "urlLink": [
          {
            "url": "https://example.com",
            "urlType": "website",
            "crawlCdnProvider": "cloudflare",
            "crawlRenderMode": "static",
            "createdAt": "2024-01-15T09:30:00Z",
            "id": 1,
            "isCurrent": true,
            "isPrimary": true,
            "owner": {
              "entityId": "string",
              "personId": "string"
            },
            "sourceId": "string",
            "status": "string",
            "statusChecked": "2024-01-15T09:30:00Z",
            "updatedAt": "2024-01-15T09:30:00Z"
          }
        ]
      },
      "investment": [
        {
          "company": {
            "entity": {
              "id": "string",
              "image": {
                "isMonogram": true,
                "logo": "string",
                "logoSquare": "string"
              },
              "nameAlias": [
                {
                  "name": "Bun",
                  "displayable": true,
                  "type": "alternativeDba"
                }
              ],
              "nameBrand": "string",
              "slug": "aventure-vc",
              "defaultCurrency": "string",
              "foundedYear": 1,
              "lastModifiedAt": "2024-01-15T09:30:00Z",
              "nameLegal": "string",
              "operatingStatus": "string",
              "publicId": "eV1StGXR8Z5a",
              "publicUrl": "string",
              "sitemap": {
                "hasAnalysis": true,
                "hasEmployees": true,
                "hasFundraising": true,
                "hasNews": true,
                "productServiceSlug": [
                  "string"
                ],
                "hasAcquisitions": false
              },
              "typeRecord": "Company",
              "updatedAt": "2024-01-15T09:30:00Z"
            }
          },
          "fundraiseTransactionId": "string",
          "id": "string",
          "investmentDate": "2024-01-15T09:30:00Z",
          "amount": 1.1,
          "date": "2024-01-15T09:30:00Z",
          "fundraiseTransaction": {
            "id": "string",
            "image": {
              "isMonogram": true,
              "logo": "string",
              "logoSquare": "string"
            },
            "nameBrand": "string",
            "amountRaised": 1.1,
            "dateAnnounced": "2024-01-15T09:30:00Z",
            "investorCount": 1,
            "round": "string",
            "status": "string",
            "valuationPostMoney": 1.1
          },
          "investorAttribution": {
            "attributionType": "direct",
            "joinId": "string",
            "leadInvestor": true,
            "transactionId": "string",
            "amountInvested": 1.1,
            "beneficialEntityId": "string",
            "fundManagerRelationshipId": 1,
            "recordedEntityId": "string",
            "round": {
              "round": "string"
            }
          },
          "round": "string"
        }
      ],
      "nameAlias": [
        {
          "name": "Bun",
          "displayable": true,
          "type": "nickname"
        }
      ],
      "articleCount": 1
    }
  ],
  "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
}

Enrich multiple people by id or slug with optional url, association, and address. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. A signed-in user’s read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.

Enrich multiple people by id or slug with optional url, association, and address. When page and size are omitted, the full deduplicated batch is returned in request order. Sort is not supported for this fixed-order batch response. A signed-in user's read charges one view per distinct returned record against the monthly entity or person view allowance; a repeat read of the same record in the month is free, and an exhausted cap answers 429 with Retry-After. Service-credential (client secret or admin API key) and anonymous reads are never charged.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Query parameters

includePrivatebooleanOptional

Includes private fields when the caller has private-visibility authority. Omit to use the caller’s default visibility.

pageintegerOptional

Zero-based page index (0..N); omit page and size for the full batch.

sizeintegerOptional

The size of the page to be returned; omit page and size for the full batch.

Request

This endpoint expects an object.

hasImageFirstbooleanOptionalDefaults to false

Sort results by image presence

includeAddressbooleanOptionalDefaults to true

Include address values

includeAssociationbooleanOptionalDefaults to true

Include association values

includeUrlbooleanOptionalDefaults to true

Include URL links

maxAssociationsintegerOptionalDefaults to 40

Max association values per person

permitMonogrambooleanOptionalDefaults to true

Permit monogram fallbacks

personIdlist of stringsOptional

Person UUID values

sluglist of stringsOptional

Person slug values

urllist of stringsOptional

Person URL values

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

401

Unauthorized Error

403

Forbidden Error

406

Not Acceptable Error

409

Conflict Error

415

Unsupported Media Type Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error