Search History

The search history endpoint returns the screening requests your tenant has run. Use it for audit retrieval: a compliance team can reconcile which screenings ran, when they ran, who ran them where Minerva recorded a user, and which submitted entities and feeds each request included.

Search history retrieval is read-only. It does not submit a new screening, change review status, or modify historical records.

Endpoint

GET https://api.gominerva.com/v2/search/requests

Authenticate with the same API key header the other Minerva API endpoints use:

x-api-key: YOUR_API_KEY

The API key determines the tenant whose historical requests are returned. Create and manage keys from Administration > Developers in the Minerva dashboard, or see API Keys.

Query parameters

Parameter	Description
`page`	One-based page number. Defaults to `1`.
`limit`	Number of requests to return per page. Defaults to `10` and is capped at `250`.
`q`	Optional case-insensitive search against submitted entity names.
`job_id`	Optional search job identifier to retrieve requests from a specific job.
`created_at_from`	Inclusive lower bound for the request creation time.
`created_at_to`	Inclusive upper bound for the request creation time.
`sort_key`	Sort field. Only `created_at` is currently supported.
`sort`	Sort direction: `desc` or `asc`. Defaults to `desc`.

Use RFC3339 date-time values with an explicit timezone, such as 2026-05-01T00:00:00Z. When you build URLs, use your HTTP client’s query parameter encoder, URLSearchParams, or --data-urlencode, so reserved characters such as : and + are encoded safely.

List recent search requests

curl -G "https://api.gominerva.com/v2/search/requests" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "limit=25" \
  --data-urlencode "sort=desc"

const params = new URLSearchParams({
  limit: "25",
  sort: "desc",
});

const response = await fetch(
  `https://api.gominerva.com/v2/search/requests?${params}`,
  {
    headers: {
      "x-api-key": process.env.MINERVA_API_KEY,
    },
  },
);

if (!response.ok) {
  throw new Error(`Minerva API returned ${response.status}`);
}

const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.gominerva.com/v2/search/requests",
    headers={"x-api-key": os.environ["MINERVA_API_KEY"]},
    params={"limit": 25, "sort": "desc"},
    timeout=30,
)
response.raise_for_status()

data = response.json()

Retrieve a date range

Date range filters are inclusive and apply to the request’s created_at timestamp.

curl -G "https://api.gominerva.com/v2/search/requests" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "created_at_from=2026-05-01T00:00:00Z" \
  --data-urlencode "created_at_to=2026-05-31T23:59:59Z" \
  --data-urlencode "limit=100" \
  --data-urlencode "sort=asc"

const params = new URLSearchParams({
  created_at_from: "2026-05-01T00:00:00Z",
  created_at_to: "2026-05-31T23:59:59Z",
  limit: "100",
  sort: "asc",
});

const response = await fetch(
  `https://api.gominerva.com/v2/search/requests?${params}`,
  {
    headers: {
      "x-api-key": process.env.MINERVA_API_KEY,
    },
  },
);

if (!response.ok) {
  throw new Error(`Minerva API returned ${response.status}`);
}

const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.gominerva.com/v2/search/requests",
    headers={"x-api-key": os.environ["MINERVA_API_KEY"]},
    params={
        "created_at_from": "2026-05-01T00:00:00Z",
        "created_at_to": "2026-05-31T23:59:59Z",
        "limit": 100,
        "sort": "asc",
    },
    timeout=30,
)
response.raise_for_status()

data = response.json()

Example response

{
  "pagination": {
    "page": 1,
    "limit": 2,
    "total_count": 42,
    "total_pages": 21,
    "has_next": true,
    "has_prev": false
  },
  "requests": [
    {
      "id": "665f0d4c2d2f7c2b2f2f2f2f",
      "legacy_search_id": "legacy-search-123",
      "tenant_id": "org_123",
      "config": {
        "feeds": ["Sanctions", "PEP"]
      },
      "entities": [
        {
          "type": "individual",
          "name": "Jane Doe",
          "feeds": ["Sanctions", "PEP"],
          "custom_id": "case-1001"
        }
      ],
      "created_at": "2026-05-14T13:22:45Z",
      "updated_at": "2026-05-14T13:22:48Z",
      "user_id": "user_123",
      "user_name": "Compliance Analyst",
      "user_email": "analyst@example.com",
      "job_id": "665f0d4c2d2f7c2b2f2f2f30"
    }
  ]
}

Paginate an audit export

For a full audit export, request pages until pagination.has_next is false. Keep the same filters on each page so the result set remains consistent.

JavaScript

let page = 1;
let hasNext = true;
const allRequests = [];

while (hasNext) {
  const params = new URLSearchParams({
    created_at_from: "2026-05-01T00:00:00Z",
    created_at_to: "2026-05-31T23:59:59Z",
    limit: "250",
    page: String(page),
  });

  const response = await fetch(
    `https://api.gominerva.com/v2/search/requests?${params}`,
    { headers: { "x-api-key": process.env.MINERVA_API_KEY } },
  );

  if (!response.ok) {
    throw new Error(`Minerva API returned ${response.status}`);
  }

  const data = await response.json();
  allRequests.push(...data.requests);
  hasNext = data.pagination.has_next;
  page += 1;
}

Retrieve associated results

The search history response gives you the request metadata and the request identifier. When you need the stored match-level results for a historical request, use the returned id as the request_id on the search matches endpoint.

cURL

curl -G "https://api.gominerva.com/v2/search/matches" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "request_id=665f0d4c2d2f7c2b2f2f2f2f" \
  --data-urlencode "limit=100"

The response returns the stored potential match objects. They use the same field layout as a direct search response, so the field descriptions and the recommended analyst review order in the Screening Integration Guide apply to them as well.

API Documentation

Screening - Endpoints

Admin Actions - Endpoints

Profiles - Endpoints

Agent Risk Assessments - Endpoints

Identity Verification - Endpoints

Endpoint

Query parameters

List recent search requests

Retrieve a date range

Example response

Paginate an audit export

Retrieve associated results

​Endpoint

​Query parameters

​List recent search requests

​Retrieve a date range

​Example response

​Paginate an audit export

​Retrieve associated results

Endpoint

Query parameters

List recent search requests

Retrieve a date range

Example response

Paginate an audit export

Retrieve associated results