Skip to main content
POST
/
enrichment
/
profiles
curl --request POST \
  --url https://api.goldilocksai.app/enrichment/profiles \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "people_ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "123e4567-e89b-12d3-a456-426614174001"
  ],
  "enrichment_type": "email"
}
'
{
  "success": true,
  "data": {
    "profiles": [
      {
        "people_id": "123e4567-e89b-12d3-a456-426614174000",
        "email": [
          {
            "email": "john.doe@example.com",
            "priority": 1
          }
        ]
      }
    ]
  },
  "metadata": {
    "results": {
      "total_profiles_requested_enrichment": 2,
      "total_profiles_enriched": 1,
      "warnings": [
        {
          "people_id": "123e4567-e89b-12d3-a456-426614174001",
          "type": "W0001_ENRICHMENT_UNAVAILABLE_TYPE",
          "enrichment_type": "email",
          "reason": "Profile does not have email data"
        }
      ]
    }
  },
  "error": null,
  "request_id": "abc12345-e89b-12d3-a456-426614174000",
  "processing_time_ms": 250
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Obtain your API key via the web application.

Body

application/json

Request body for enriching profiles

​
people_ids
string<uuid>[]
required

List of people IDs to enrich (max 50 per request)

Required array length: 1 - 50 elements

UUID v4 identifier

Example:
[
  "123e4567-e89b-12d3-a456-426614174000",
  "123e4567-e89b-12d3-a456-426614174001"
]
​
enrichment_type
enum<string>
required

Type of enrichment data to retrieve

Available options:
email,
phone,
award,
publication,
membership,
patent

Response

Enrichment completed successfully

​
success
boolean
required
​
request_id
string<uuid>
required
​
processing_time_ms
integer
required
​
data
object

Response data for POST /enrichment/profiles. Metadata is returned at the envelope level, not nested here.

​
metadata
object

Metadata for POST /enrichment/profiles

​
error
null