Resource group

Individuals

Manage investor and buyer records in Covent. Public V1 should expose a composed individual resource instead of forcing developers through several app-shaped internal endpoints.

Endpoint Reference

Open a specific endpoint to see SDK call examples, request parameters, and response details.

GET

Get Individuals

View Endpoint
/api/v1/individuals

Retrieve individuals with optional filters for status, source, or search criteria.

POST

Create A New Investor Or Buyer Record In Covent

View Endpoint
/api/v1/individuals

Create a new investor or buyer record in Covent.

GET

Get A Composed Individual Record

View Endpoint
/api/v1/individuals/{id}

Retrieve a composed individual record including general profile context.

PATCH

Update General Profile Data

View Endpoint
/api/v1/individuals/{id}

Update general profile data such as status, tags, or relationship metadata.

GET

Get An Individual's Acquisition Criteria And Deal Preferences

View Endpoint
/api/v1/individuals/{id}/buy-box

Retrieve an individual's acquisition criteria and deal preferences.

PATCH

Update An Individual's Buy Box Criteria

View Endpoint
/api/v1/individuals/{id}/buy-box

Update an individual's buy box criteria.

GET

Get Portfolio Composition, Holdings, And Portfolio-level Metrics

View Endpoint
/api/v1/individuals/{id}/portfolio

Retrieve portfolio composition, holdings, and portfolio-level metrics.

GET

Get Listings Associated

View Endpoint
/api/v1/individuals/{id}/listings

Retrieve listings associated with the individual through matches, engagement, walkthroughs, or offers.

GET

List Phone Numbers For An Individual

View Endpoint
/api/v1/individuals/{id}/phones

List phone numbers for an individual.

POST

Create A Phone Number For An Individual

View Endpoint
/api/v1/individuals/{id}/phones

Create a phone number for an individual.

GET

List Email Addresses For An Individual

View Endpoint
/api/v1/individuals/{id}/emails

List email addresses for an individual.

POST

Create An Email Address For An Individual

View Endpoint
/api/v1/individuals/{id}/emails

Create an email address for an individual.

GET

List Notes

View Endpoint
/api/v1/individuals/{id}/notes

List notes tied to an individual.

POST

Create A Note

View Endpoint
/api/v1/individuals/{id}/notes

Create a note tied to an individual.