Skip to main content
POST
/
v1
/
search-sync
Single Search Synchronous API (POST)
curl --request POST \
  --url https://api.gominerva.com/v1/search-sync \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "individual",
  "name": "John Smith",
  "feeds": [
    "Sanctions",
    "PEP",
    "News"
  ],
  "gender": "Male",
  "year": 1970,
  "month": 6,
  "day": 11,
  "city": "Toronto",
  "state": "Ontario",
  "country": "Canada",
  "occupation": "Software Developer",
  "organization": "Minerva",
  "address": "<string>",
  "phone": "<string>",
  "email": "<string>",
  "personalID": "<string>",
  "ssn": "<string>",
  "regID": "<string>",
  "notes": "Personal website: www.johnsmith.com",
  "externalId": "12345678",
  "match_threshold": 123,
  "max_lookback_days": 123,
  "soft_match": true,
  "location_match_strictness": "city",
  "omit_open_source": true
}
'
{
  "status": 200,
  "message": "Search successfully completed.",
  "jobid": "adf48860-6a96-43a4-b008-37eccd139e3a",
  "dashboardViewLink": "https://app.gominerva.com/dashboard?requestId=REQUEST_ID&jobId=JOB_ID#results",
  "request": {
    "type": "Individual",
    "name": "John Smith",
    "gender": "Male",
    "year": 1970,
    "month": 6,
    "day": 11,
    "city": "Toronto",
    "state": "Ontario",
    "country": "Canada",
    "occupation": "Software Developer",
    "organization": "MinervaAI",
    "email": "john.smith@gmail.com",
    "phone": "+15555555555",
    "personalID": "A1234-BCDEF-GHIJK",
    "regID": "19288709",
    "notes": "Personal website: www.johnsmith.com",
    "externalId": "12345678",
    "global_filters": {
      "location_match_strictness": "city",
      "match_threshold": 0.8,
      "soft_match": true
    },
    "feed_filters": {
      "Sanctions": {
        "location_match_strictness": "country",
        "soft_match": true,
        "match_threshold": 0.9
      }
    },
    "custom_id": "customer_01"
  },
  "results": [
    {
      "type": 0,
      "name": {
        "value": "Smith",
        "first": {
          "value": "Software Engineer",
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "timestamp": {
            "year": 1984,
            "month": 6,
            "day": 15
          },
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.95,
          "criteria_match_level": "close",
          "tag": "LinkedIn"
        },
        "other_names": [
          {
            "value": "Software Engineer",
            "sources": [
              {
                "value": "John Smith",
                "source": "OFAC SDN List",
                "feed": "Sanctions",
                "timestamp": {
                  "year": 1984,
                  "month": 6,
                  "day": 15
                },
                "inferred": false,
                "reputation_score": 8,
                "trusted": true,
                "match_score": 0.92,
                "criteria_match_level": "close"
              }
            ],
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.95,
            "criteria_match_level": "close",
            "tag": "LinkedIn"
          }
        ],
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.98,
        "criteria_match_level": "close"
      },
      "sources": [
        "OFAC SDN List",
        "World Leaders Database",
        "Reuters"
      ],
      "source_details": [
        {
          "name": "OFAC SDN List",
          "source_feed": "Sanctions",
          "flagged_feeds": [
            "Sanctions",
            "PEP"
          ],
          "urls": [
            {
              "url": "https://www.bbc.com/news/article-123",
              "title": "Breaking News: Major Development",
              "source_name": "BBC News",
              "snippet": "The individual was mentioned in connection with...",
              "language": "en",
              "flags": {
                "sentiment": [
                  "Negative (High)"
                ],
                "risk": [
                  "Money Laundering (High)",
                  "Fraud/Bribery/Corruption (Medium)"
                ]
              },
              "http_status_code": 200,
              "date_time_published": "2024-01-15T10:30:00Z"
            }
          ],
          "description": "Official US Treasury sanctions database",
          "inferences": [
            {
              "feed": "PEP",
              "reason": "Matched regex pattern for political position",
              "url": "https://example.com/article",
              "field": "Notes",
              "context": "The individual served as Minister of..."
            }
          ]
        }
      ],
      "last_updated": "Saturday, Jun 26 2021 - 03:05:55 GMT00:00",
      "merge_id": "merge_abc123",
      "pep_level": 2,
      "aliases": [
        {
          "value": "Smith",
          "first": {
            "value": "Software Engineer",
            "sources": [
              {
                "value": "John Smith",
                "source": "OFAC SDN List",
                "feed": "Sanctions",
                "timestamp": {
                  "year": 1984,
                  "month": 6,
                  "day": 15
                },
                "inferred": false,
                "reputation_score": 8,
                "trusted": true,
                "match_score": 0.92,
                "criteria_match_level": "close"
              }
            ],
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.95,
            "criteria_match_level": "close",
            "tag": "LinkedIn"
          },
          "other_names": [
            {
              "value": "Software Engineer",
              "sources": [
                {
                  "value": "John Smith",
                  "source": "OFAC SDN List",
                  "feed": "Sanctions",
                  "timestamp": {
                    "year": 1984,
                    "month": 6,
                    "day": 15
                  },
                  "inferred": false,
                  "reputation_score": 8,
                  "trusted": true,
                  "match_score": 0.92,
                  "criteria_match_level": "close"
                }
              ],
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.95,
              "criteria_match_level": "close",
              "tag": "LinkedIn"
            }
          ],
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.98,
          "criteria_match_level": "close"
        }
      ],
      "gender": {
        "value": "Male",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "inferred": false,
        "reputation_score": 7,
        "trusted": true,
        "match_score": 1,
        "criteria_match_level": "close"
      },
      "company_type": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "industry": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "company_size": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "status": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "occupation": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "organization": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "nationality": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "time_begin": {
        "value": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "sources": [
          {
            "value": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "inferred": false,
        "reputation_score": 9,
        "trusted": true,
        "match_score": 1,
        "criteria_match_level": "close"
      },
      "time_end": {
        "value": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "sources": [
          {
            "value": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "inferred": false,
        "reputation_score": 9,
        "trusted": true,
        "match_score": 1,
        "criteria_match_level": "close"
      },
      "alt_times": [
        {
          "value": {
            "year": 1984,
            "month": 6,
            "day": 15
          },
          "sources": [
            {
              "value": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "inferred": false,
          "reputation_score": 9,
          "trusted": true,
          "match_score": 1,
          "criteria_match_level": "close"
        }
      ],
      "place_of_birth": {
        "value": "Software Engineer",
        "sources": [
          {
            "value": "John Smith",
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.92,
            "criteria_match_level": "close"
          }
        ],
        "timestamp": {
          "year": 1984,
          "month": 6,
          "day": 15
        },
        "inferred": false,
        "reputation_score": 8,
        "trusted": true,
        "match_score": 0.95,
        "criteria_match_level": "close",
        "tag": "LinkedIn"
      },
      "contact": {
        "email": [
          {
            "value": "Software Engineer",
            "sources": [
              {
                "value": "John Smith",
                "source": "OFAC SDN List",
                "feed": "Sanctions",
                "timestamp": {
                  "year": 1984,
                  "month": 6,
                  "day": 15
                },
                "inferred": false,
                "reputation_score": 8,
                "trusted": true,
                "match_score": 0.92,
                "criteria_match_level": "close"
              }
            ],
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.95,
            "criteria_match_level": "close",
            "tag": "LinkedIn"
          }
        ],
        "phone": [
          {
            "value": "Software Engineer",
            "sources": [
              {
                "value": "John Smith",
                "source": "OFAC SDN List",
                "feed": "Sanctions",
                "timestamp": {
                  "year": 1984,
                  "month": 6,
                  "day": 15
                },
                "inferred": false,
                "reputation_score": 8,
                "trusted": true,
                "match_score": 0.92,
                "criteria_match_level": "close"
              }
            ],
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.95,
            "criteria_match_level": "close",
            "tag": "LinkedIn"
          }
        ]
      },
      "media": {
        "risk_urls": [
          {
            "url": "https://www.bbc.com/news/article-123",
            "title": "Breaking News: Major Development",
            "source_name": "BBC News",
            "snippet": "The individual was mentioned in connection with...",
            "language": "en",
            "flags": {
              "sentiment": [
                "Negative (High)"
              ],
              "risk": [
                "Money Laundering (High)",
                "Fraud/Bribery/Corruption (Medium)"
              ]
            },
            "http_status_code": 200,
            "date_time_published": "2024-01-15T10:30:00Z"
          }
        ],
        "neutral_urls": [
          {
            "url": "https://www.bbc.com/news/article-123",
            "title": "Breaking News: Major Development",
            "source_name": "BBC News",
            "snippet": "The individual was mentioned in connection with...",
            "language": "en",
            "flags": {
              "sentiment": [
                "Negative (High)"
              ],
              "risk": [
                "Money Laundering (High)",
                "Fraud/Bribery/Corruption (Medium)"
              ]
            },
            "http_status_code": 200,
            "date_time_published": "2024-01-15T10:30:00Z"
          }
        ],
        "usernames": [
          {
            "value": "john_smith_official",
            "tag": "Twitter",
            "sources": [
              {
                "value": "Software Engineer",
                "sources": [
                  {
                    "value": "John Smith",
                    "source": "OFAC SDN List",
                    "feed": "Sanctions",
                    "timestamp": {
                      "year": 1984,
                      "month": 6,
                      "day": 15
                    },
                    "inferred": false,
                    "reputation_score": 8,
                    "trusted": true,
                    "match_score": 0.92,
                    "criteria_match_level": "close"
                  }
                ],
                "timestamp": {
                  "year": 1984,
                  "month": 6,
                  "day": 15
                },
                "inferred": false,
                "reputation_score": 8,
                "trusted": true,
                "match_score": 0.95,
                "criteria_match_level": "close",
                "tag": "LinkedIn"
              }
            ]
          }
        ]
      },
      "locations": [
        {
          "value": "Software Engineer",
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "timestamp": {
            "year": 1984,
            "month": 6,
            "day": 15
          },
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.95,
          "criteria_match_level": "close",
          "tag": "LinkedIn"
        }
      ],
      "images": [
        {
          "value": "Software Engineer",
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "timestamp": {
            "year": 1984,
            "month": 6,
            "day": 15
          },
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.95,
          "criteria_match_level": "close",
          "tag": "LinkedIn"
        }
      ],
      "other_fields": {},
      "links": [
        {
          "value": "Acme Corporation",
          "type": {
            "value": "Software Engineer",
            "sources": [
              {
                "value": "John Smith",
                "source": "OFAC SDN List",
                "feed": "Sanctions",
                "timestamp": {
                  "year": 1984,
                  "month": 6,
                  "day": 15
                },
                "inferred": false,
                "reputation_score": 8,
                "trusted": true,
                "match_score": 0.92,
                "criteria_match_level": "close"
              }
            ],
            "timestamp": {
              "year": 1984,
              "month": 6,
              "day": 15
            },
            "inferred": false,
            "reputation_score": 8,
            "trusted": true,
            "match_score": 0.95,
            "criteria_match_level": "close",
            "tag": "LinkedIn"
          },
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.85,
          "criteria_match_level": "close"
        }
      ],
      "ID": {},
      "documents": [
        {
          "url": "https://www.bbc.com/news/article-123",
          "title": "Breaking News: Major Development",
          "source_name": "BBC News",
          "snippet": "The individual was mentioned in connection with...",
          "language": "en",
          "flags": {
            "sentiment": [
              "Negative (High)"
            ],
            "risk": [
              "Money Laundering (High)",
              "Fraud/Bribery/Corruption (Medium)"
            ]
          },
          "http_status_code": 200,
          "date_time_published": "2024-01-15T10:30:00Z"
        }
      ],
      "websites": [
        {
          "value": "Software Engineer",
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "timestamp": {
            "year": 1984,
            "month": 6,
            "day": 15
          },
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.95,
          "criteria_match_level": "close",
          "tag": "LinkedIn"
        }
      ],
      "notes": [
        {
          "value": "Software Engineer",
          "sources": [
            {
              "value": "John Smith",
              "source": "OFAC SDN List",
              "feed": "Sanctions",
              "timestamp": {
                "year": 1984,
                "month": 6,
                "day": 15
              },
              "inferred": false,
              "reputation_score": 8,
              "trusted": true,
              "match_score": 0.92,
              "criteria_match_level": "close"
            }
          ],
          "timestamp": {
            "year": 1984,
            "month": 6,
            "day": 15
          },
          "inferred": false,
          "reputation_score": 8,
          "trusted": true,
          "match_score": 0.95,
          "criteria_match_level": "close",
          "tag": "LinkedIn"
        }
      ],
      "checklist": {
        "screen": {
          "Sanctions": true,
          "PEP": true,
          "Criminal": true,
          "Legal": true,
          "News": true,
          "Open Source": true,
          "Social Media": true,
          "Registries": true,
          "Ownership": true,
          "Offshore": true
        },
        "hits": {
          "Sanctions": [
            "OFAC SDN List",
            "EU Consolidated List"
          ],
          "PEP": [
            "World Leaders Database"
          ],
          "Criminal": [
            "FBI Most Wanted"
          ],
          "Legal": [
            "PACER"
          ],
          "News": [
            "Reuters",
            "BBC News"
          ],
          "Open Source": [
            "<string>"
          ],
          "Social Media": [
            "<string>"
          ],
          "Registries": [
            "<string>"
          ],
          "Ownership": [
            "<string>"
          ],
          "Offshore": [
            "<string>"
          ]
        },
        "hits_info": [
          {
            "source": "OFAC SDN List",
            "feed": "Sanctions",
            "name": {
              "value": "John Smith",
              "match_score": 0.95,
              "criteria_match_level": "close"
            },
            "occupation": {
              "value": "John Smith",
              "match_score": 0.95,
              "criteria_match_level": "close"
            },
            "organization": {
              "value": "John Smith",
              "match_score": 0.95,
              "criteria_match_level": "close"
            },
            "nationality": {
              "value": "John Smith",
              "match_score": 0.95,
              "criteria_match_level": "close"
            },
            "date": {
              "value": "John Smith",
              "match_score": 0.95,
              "criteria_match_level": "close"
            },
            "locations": [
              {
                "value": "John Smith",
                "match_score": 0.95,
                "criteria_match_level": "close"
              }
            ]
          }
        ]
      },
      "client_risk_rating": {
        "score": 0.75,
        "label": "High",
        "factors": [
          {
            "weight": 0.15,
            "value": 0.8,
            "code": 1,
            "label": "Sanctions List",
            "annotation": "Listed on OFAC SDN"
          }
        ]
      },
      "score": 0.95,
      "match_score_info": {
        "name": {
          "score": 0.98,
          "criteria_match_level": "exact",
          "verified": true
        },
        "country": {
          "score": 0.85,
          "criteria_match_level": "close",
          "verified": true
        }
      },
      "review_status": "unresolved",
      "reportURL": "https://storage.googleapis.com/..."
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

The uuidv4 API key associated with the MinervaAI account making the request.

Body

application/json
​
type
enum<string>
required

The type of profile to search for.

Available options:
individual,
organization
Example:

"individual"

​
name
string
required

The full legal name of the search subject.

Example:

"John Smith"

​
feeds
string[]
required

Array of feeds to include in the search scope.

Example:
["Sanctions", "PEP", "News"]
​
gender
string

The gender of the individual (individual searches only).

Example:

"Male"

​
year
integer

Birth year for individuals or founding year for organizations.

Example:

1970

​
month
integer

Birth/founding month (1 = January).

Required range: 1 <= x <= 12
Example:

6

​
day
integer

Birth/founding day.

Required range: 1 <= x <= 31
Example:

11

​
city
string

City, town, or municipality.

Example:

"Toronto"

​
state
string

State or province.

Example:

"Ontario"

​
country
string

Country or nationality.

Example:

"Canada"

​
occupation
string

Job title or role (individual searches only).

Example:

"Software Developer"

​
organization
string

Associated organization (individual searches only).

Example:

"Minerva"

​
address
string

Full address including lines 1 and 2.

​
phone
string

E.164 compliant international phone number.

​
email
string

Email address associated with the profile.

​
personalID
string

Personal ID such as passport or driver's license (individual searches only).

​
ssn
string

Social Security Number (individual searches only). Encrypted on server side.

​
regID
string

Registration ID (organization searches only).

​
notes
string

Additional notes or information.

Example:

"Personal website: www.johnsmith.com"

​
externalId
string

External identifier for tracking purposes.

Example:

"12345678"

​
match_threshold
number

Custom match threshold below which results will not be returned.

​
max_lookback_days
number

Max window in days for supported feeds (currently News feed only).

​
soft_match
boolean

Whether to use soft matching (default behavior).

​
location_match_strictness
enum<string>

Geographic exclusion resolution level.

Available options:
city,
state,
country
​
omit_open_source
boolean

Whether to omit open source feed for feeds that include it automatically.

Response

Search successfully completed. Returns the search results synchronously.

​
status
integer
Example:

200

​
message
string
Example:

"Search successfully completed."

​
jobid
string
Example:

"adf48860-6a96-43a4-b008-37eccd139e3a"

​
dashboardViewLink
string
Example:

"https://app.gominerva.com/dashboard?requestId=REQUEST_ID&jobId=JOB_ID#results"

​
request
object
​
results
object[]

Up to 10 potential matches ranked by criteria match score, resolved using entity resolution technology. Each result is a Profile object containing rich profile information with source lineage.