Identity Resolution

Batch resolve identities

post

Resolve identities for a batch of records. Each record must include:

• record_id (your unique identifier to track results)
• first_name
• last_name
• phones (array of strings)
• emails (array of strings)

At least one phone or email is required.

Though we return results in the order requested, we recommend using your record_id to correlate with your original inputs.

Authorizations

OAuthStaticTokenAuth

Header parameters

AuthorizationanyOptional

Bearer (OAuth) token containing the previously obtained minerva_api_oauth_token.

x-api-keyanyOptional

API Key (x-api-key) Use your static API key in the x-api-key header.

Content-TypestringRequiredExample: application/json

Body

Responses

200

Resolution results

application/json

400

Bad request (missing fields, invalid JSON, etc.)

401

Unauthorized (invalid or missing token)

post

cURL-OAuthcURL-Static-TokenPython-OauthPython-Static-Token

curl -i -X POST \
  https://api.minerva.io/v1/resolve \
  -H "Authorization: Bearer <REPLACE_WITH_ID_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "record_id": "03c59496-7d74-4b77-bb5d-c6c9325435fb",
        "first_name": "Mathew",
        "last_name": "Joseph",
        "phones": ["[phone]"],
        "emails": ["[e-mail]"]
      },
      {
        "record_id": "05998f8f-73e8-4aec-b267-916b41b806d3",
        "first_name": "Alexander",
        "last_name": "Wilde",
        "phones": ["[phone]"],
        "emails": ["[e-mail]"]
      }
    ]
  }'

{
  "api_request_id": "0222508f-45e2-4c09-a79e-b411576aac49",
  "results": [
    {
      "record_id": "c786fb93-1f3b-dc11-8670-000bdba91a39",
      "is_match": true,
      "minerva_pid": "p-ceef1fd768e389abd4d33fdd901a5964",
      "match_score": 122.5,
      "is_resolvable_record": true,
      "validation_errors": "None"
    }
  ],
  "request_completed_at": "2025-01-18T02:40:14.496887+00:00"
}