With the Enrich Person API Endpoint, you can get all the data available on a chosen person. You can then use this data to enrich the person in your chosen CRM or other location.
Use case
An example use case is to fetch all person data whenever you receive a new lead in your CRM by making an API call based on the person information available of the inbound lead. You can then save this data into your CRM.
If you have lead scoring set up in your CRM, you can use this data to assign an appropriate score for your marketing department.
This will also help the sales team to better assess the value of the inbound lead, according to the properties enriched by Ocean (job title, department, seniority, et cetera).
Step-by-step guide
Here's a step-by-step guide to making an API call to the Enrich Person API Endpoint, using Postman.
Click on + in your workspace to add a new call.
Ensure the request type is set to POST
Copy and paste the link below into the Enter URL or paste text field, where you replace XXX with your API token (need help to find your API token?)
Ensure you add Content-Type: application/json in your Headers.
In the Body, parse whatever information you already have available for the person. In this example, we only know that the email address is [email protected]. We recommend to parse as much information as you have on the person to get the highest likeliness to find a match. Click here for the full list of possible attributes to parse.
{
"person": {
"email": "[email protected]"
}
}
Ensure you choose JSON in the Body, before hitting Send and make your call.
That's it! Now you can find all the data related to this person.
💸 Credit usage: Calling this endpoint costs 0.2 credit per returned person. If you also request our system to reveal their email, it will additionally cost 1 credit per verified email or verified catch-all email.
📅 Did your subscription start before February 2026 or do you have a custom plan? Then you might be on our legacy plan. See this support article for more details (only accessible for legacy customers).