StopList API (FinCERT)

API Methods

Method	URL	Description
POST	admin-apps/reports/import-history	Get feed import history
POST	admin-apps/reports/lead-checks	Lead check statistics

Get Feed Import History

POST /admin-apps/reports/import-history

Description

This method is designed to retrieve the history of FinCERT feed imports with the ability to filter by date and feed type. It returns information about each import, including the number of records and import time.

Request Parameters

{
  "searchFields": [
    {
      "field": "string", // Field name for filtering (allowed values: "feed_type", "imported_at")
      "value": "string" // Filter value (e.g., "phone_number", ">=YYYY-MM-DD HH:MM:SS", "<=YYYY-MM-DD HH:MM:SS")
    }
    // Multiple objects can be added for combined filters
  ]
}

Filter Parameters:

• "field" (string, required) — the name of the field to filter by.
  • Allowed values: "feed_type", "imported_at".
• "value" (string, required) — the filter value.
  • For field: "feed_type": a string corresponding to the feed type (e.g., "phone_number"). An empty string "" means no filter by feed type.
  • For field: "imported_at": a string with a comparison operator and date/time in the format ">=YYYY-MM-DD HH:MM:SS" or "<=YYYY-MM-DD HH:MM:SS".

Possible values for field: "feed_type":

• "" (empty string) — no filter by type.
• passport_hash — recipient passport hashes.
• snils_hash — recipient SNILS hashes.
• inn — recipient TINs.
• card_number — recipient card numbers.
• phone_number — recipient phone numbers.
• account_number — account numbers + bank BIC.
• fastpay_number — FPS identifiers.
• ewallet_number — electronic wallets.
• swift — accounts + SWIFT BIC bank.

Example Successful Response

[
  {
    "id": 46858, // Unique import identifier
    "feed_type": "phone_number", // Feed type
    "records_count": 1250, // Number of records in import
    "imported_at": "2025-10-07T17:11:58.384557+03:00" // Import time
  },
  {
    "id": 45371,
    "feed_type": "card_number",
    "records_count": 186,
    "imported_at": "2025-10-03T17:08:00.234717+03:00"
  },
  {
    "id": 45366,
    "feed_type": "account_number",
    "records_count": 184,
    "imported_at": "2025-10-03T17:07:59.879446+03:00"
  }
]

Default "searchFields": []

If you send a request with an empty "searchFields": [] array without specifying specific filters, the API will automatically apply date filters for the last 30 days and all feed types:

• All feed types are returned: ewallet_number, phone_number, passport_hash, account_number, card_number, inn, snils_hash, fast_pay_number.
• Data is sorted by imported_at in descending order (most recent first).

Example Request:

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": []
}

Filter by Date

Displays all feed types within the specified date range (e.g., from January 1 to December 31, 2025).

Example Request:

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": [
    {"field": "imported_at", "value": ">=2025-01-01 00:00:00"},
    {"field": "imported_at", "value": "<=2025-12-31 23:59:59"}
  ]
}

Filter by Feed Type

Since no date and time filter is set, it displays data for a specific feed type for the last 30 days (default value).

Example Request:

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": [
    {"field": "feed_type", "value": "card_number"}
  ]
}

Filter by Date + Feed

For example, displays only imports of type "phone_number" from October 1, 2025 to the present.

Example Request:

POST /admin-apps/reports/import-history
Content-Type: application/json

{
  "searchFields": [
    {"field": "imported_at","value": ">=2025-10-01 00:00:00"},
    {"field": "feed_type", "value": "phone_number"}
  ]
}

Lead Check Statistics

POST /admin-apps/reports/lead-checks

Description

This method is designed to retrieve FinCERT check statistics for a specified time period. It returns the number of checks for each feed type, including the number of records found and not found in the registries.

Request Parameters

{
  "from": "2025-10-01 00:00:00", // Period start (required)
  "to": "2025-10-27 23:59:59" // Period end (required)
}

Date Format:

RFC3339 format is allowed for dates (e.g., "2025-10-01T00:00:00+03:00"), or the standard format "YYYY-MM-DD HH:MM:SS".

TIP

Important: If you don't specify the from and to parameters in the request body (send an empty body {} or don't pass a body), the method will return statistics for the entire period across all feed types.

Example Request

POST /admin-apps/reports/lead-checks
Content-Type: application/json

{
  "from": "2025-10-01 00:00:00",
  "to": "2025-10-27 23:59:59"
}

Example Successful Response

[
  {
    "feed_type": "inn", // Feed type for which checks were performed
    "found": 2, // Number of checks where the record was found in the feed registry
    "not_found": 19, // Number of checks where the record was not found in the feed registry
    "total": 21 // Total number of checks for this feed type during the specified period
  },
  {
    "feed_type": "passport_hash",
    "found": 2,
    "not_found": 136,
    "total": 138
  },
  {
    "feed_type": "phone_number",
    "found": 7,
    "not_found": 142,
    "total": 149
  },
  {
    "feed_type": "snils_hash",
    "found": 35,
    "not_found": 82,
    "total": 117
  }
]