aVenture APIPeople

Read one person's full detail by exact slug or URL

View as Markdown
Exact read: returns the full detail of the one person a slug, URL, or candidate signals prove, and 404 or 409 instead of guessing. To identify a person by name and clues, use the POST lookup on this path (CLI people lookup). Use the UUID item route for an id; any id query is rejected. Canonical redirects are preserved. 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.

Query parameters

slugstringOptional

Group A — exact person slug (URL-friendly identifier). Mutually exclusive with id, url, and every candidate signal in group C.

urlstringOptional

Group B — current person URL to resolve via strict host+path or domain-only match. Mutually exclusive with id and slug; may be combined with group-C candidate signals for URL-first fallback.

urlTypestringOptional

Optional URL type qualifier for URL lookup (e.g., ‘linkedin’, ‘twitter’). Narrows Group B (url) and Group C (urlDomain) matching. Not an identifier on its own.

urlMatchModestringOptional

URL match mode qualifier: ‘hostPath’ (strict host + path match, default) or ‘domain’ (host-only match). Not an identifier on its own.

nameFullstringOptional

Group C — candidate lookup signal: person full name. Combine with other group-C signals (nameAny, location, urlDomain) for bounded candidate search. Mutually exclusive with id and slug; may be combined with url for fallback.

nameAnystringOptional

Group C — candidate lookup signal: loose name match (any of given/family/full). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.

locationstringOptional

Group C — candidate lookup signal: person location (city, state, country). Combine with other group-C signals for bounded search. Mutually exclusive with id and slug; may be combined with url for fallback.

urlDomainstringOptional

Group C — candidate lookup signal: person URL domain (host only, no path). Combine with other group-C signals for disambiguation. Mutually exclusive with id and slug; may be combined with url for fallback.

includeUrlbooleanOptional

Projection qualifier — include URL link values in response (default: true). Set false to omit urlLink array.

includeAssociationbooleanOptional

Projection qualifier — include association values (default: true). Set false to omit association array.

includeAddressbooleanOptional

Projection qualifier — include address values (default: true). Set false to omit address array.

maxAssociationsintegerOptional

Projection qualifier — max association values to return; bounded internally to the association limit. Default: 40.

permitMonogrambooleanOptional

Permit generated monogram photo fallback (default: true). Set false to exclude monogram photos in response.

includePrivatebooleanOptional

Includes hidden or off-sitemap people and private fields when the caller has private-visibility authority.

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

Person detail as canonical JSON or compact text.
associationlist of objects
Entity associations for this person
coreobject
Canonical person core record
enrichmentobject

Supplemental person data — addresses and URL links

investmentlist of objects
Investments associated with this person
nameAliaslist of objects
Display and search aliases for this person
articleCountinteger or nullOptional

Errors

400
Bad Request Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error