Методы API
Список методов

Получение кредитного рейтинга

Запрос на добавление в очередь по методу model1

key
Ключ доступа к API
method
Метод запроса (model1)
mode
Режим работы метода (queue)
lastname
Фамилия по которой запрашивается информация
firstname
Имя по которой запрашивается информация
middlename
Отчество по которой запрашивается информация (не обязательно)
birthdate
Дата рождения в формате YYYY-MM-DD
series
Серия паспорта (не обязательно)
number
Номер паспорта (не обязательно)

Примеры запроса:

PHP
Python
C#
                        
// Входные данные
$url = "https://data.av100.org/creditrating.ashx";

// Подготовка параметров get запроса по методу model1
$request_params = array(
    "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method" => "model1",
    "mode" => "queue"
    "lastname" => "Иванов",
    "firstname" => "Иван",
    "middlename" => "Иванович",
    "birthdate" => "1800-12-12",
    "series" => "1234",
    "number" => "123456"
);

$get_params = http_build_query($request_params);

// Запрос к серверу
$response = file_get_contents($url."?".$get_params);
// Преобразование ответа
$result = json_decode($response);
                        
                    
                        
import requests

url = "https://data.av100.org/creditrating.ashx"

# подготовка параметров get запроса по методу model1
params = {
    "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
    "method": "model1",
    "mode" => "queue",
    "lastname": "Иванов",
    "firstname": "Иван",    
    "birthdate": "1800-12-12",   
    # Необязательные    
    "middlename": "Иванович",
    "series": 1234,
    "number": 123456
}

# отправка запроса
response = requests.post(
    url=url,
    params=params,
)

# преобразование ответа к словарю
data = response.json()
                        
                    
                        
using Newtonsoft.Json;
class Program
{
    static async Task Main(string[] args)
    {
        string end_point = "https://data.av100.org/creditrating.ashx";

        // Подготовка параметров get запроса по методу model1
        Dictionary dict_params = new()
        {
            { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
            { "method", "model1" },
            { "mode", "queue" },
            { "lastname", "Иванов" },
            { "firstname", "Иван" },            
            { "birthdate", "1800-12-12" },
            // не обязатальные параметры
            { "middlename", "Иванович" },
            { "series", "1234" },
            { "number", "123456" }
        };

        string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
        string url = $"{end_point}x?{url_params}";

        HttpClient client = new();
        string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();

        var result = JsonConvert.DeserializeObject(response_body);
    }
}
                        
                    

Результат вызова метода:

Описание возвращаемого JSON

start DateTime
Дата и время создание запроса
end DateTime
Дата и время окончания запроса
method String
Метод по которому формировался запрос
mode String
Режим работы мтеода. queue или result
lastname String
Фамилия по которой запрашивается информация
firtsname String
Имя по которой запрашивается информация
middlename String
Отчество по которой запрашивается информация
birthdate String
Дата рождения
series String
Серия паспорта
number String
Номер паспорта
error Boolean
Признак ошибки в запросе, имеет значение true в случае ошибки и false в случае её отсутствия
result Object
Объект с результатом возвращаемого запроса
reportId String
Идентификатор отчета

Результат запроса на добавление в очередь по методу model1 или main в случае ошибки:

  • Закончился доступ или запросы (Проверить доступ)

  • Нет необходимых прав

  • Некорректный ключ доступа или пользователь не создан

  • Отсутствует Имя

  • Отсутствует фамилия

  • Отсутствует дата рождения или указана в недопустимом формате

  • Отсутствует дата рождения или указана в недопустимом формате



  • Получение результата по методу model1

    key
    Ключ доступа к API
    method
    Метод запроса (model1)
    mode
    Режим работы метода (result)
    reportId
    Идентификатор отчета

    Примеры запроса:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.org/creditrating.ashx";
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method" => "model1",
        "mode" => "result",
        "reportId" => "44511785-211f-4467-8817-519303111602"
    );
    
    $get_params = http_build_query($request_params);
    
    // Запрос к серверу
    $response = file_get_contents($url."?".$get_params);
    // Преобразование ответа
    $result = json_decode($response);
                            
                        
                            
    import requests
    
    url = "https://data.av100.org/creditrating.ashx"
    
    # подготовка параметров get запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",    
        "method": "model1",
        "mode": "result",
        "reportId": "44511785-211f-4467-8817-519303111602"
    }
    
    # отправка запроса
    response = requests.post(
        url=url,
        params=params,
    )
    
    # преобразование ответа к словарю
    data = response.json()
                            
                        
                            
    using Newtonsoft.Json;
    class Program
    {
        static async Task Main(string[] args)
        {
            string end_point = "https://data.av100.org/creditrating.ashx";
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },            
                { "method", "model1" },
                { "mode", "result" }
                { "reportId", "44511785-211f-4467-8817-519303111602" }
            };
    
            string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
            string url = $"{end_point}?{url_params}";
    
            HttpClient client = new();
            string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();
    
            var result = JsonConvert.DeserializeObject(response_body);
        }
    }
                            
                        

    Результат вызова метода:

    Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Метод по которому формировался запрос
    lastname String
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    result Object
    Объект с результатом возвращаемого запроса
    reportId String
    Идентификатор возвращаемой задачи
    state Int
    Результат выполнения запроса: 0 - запрос на отчет создан, 1 - запрос на отчет обрабатывается, 2 - запрос на отчет обработан успешно, 3 - запрос на отчет завершился ошибкой
    reportResultType Int
    Результат выполнения запроса: 1 - успешно, 2 - субъект не найден, Null - отчет не готов или ошибка
    report Object
    Объект с результатом возвращаемого запроса
    score Float
    Скоринговый балл
    defaultProbability Float
    Значение вероятности дефолта ФЛ
    scoreTypeName String
    Кодовое название продукта.
    hasStopFactors Boolean
    Субъект имеет стоп-факторы. В таком случаескоринг не может быть рассчитан, т.к. у субъекта имеются текущие долги.

    Запрос на добавление в очередь по методу main

    key
    Ключ доступа к API
    method
    Метод запроса (main)
    mode
    Режим работы метода (queue)
    lastname
    Фамилия
    firstname
    Имя
    middlename
    Отчество
    birthdate
    Дата рождения в формате YYYY-MM-DD(не обязательно)
    series
    Серия паспорта
    number
    Номер паспорта

    Примеры запроса:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.org/creditrating.ashx";
    
    // Подготовка параметров get запроса по методу model1
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method" => "main",
        "mode" => "queue"
        "lastname" => "Иванов",
        "firstname" => "Иван",
        "middlename" => "Иванович",
        "birthdate" => "1800-12-12", // не обязательно
        "series" => "1234",
        "number" => "123456"
    );
    
    $get_params = http_build_query($request_params);
    
    // Запрос к серверу
    $response = file_get_contents($url."?".$get_params);
    // Преобразование ответа
    $result = json_decode($response);
                            
                        
                            
    import requests
    
    url = "https://data.av100.org/creditrating.ashx"
    
    # подготовка параметров get запроса по методу model1
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method": "main",
        "mode" => "queue",
        "lastname": "Иванов",
        "firstname": "Иван",    
        "birthdate": "1800-12-12", # не обязательно 
        "middlename": "Иванович",
        "series": "1234",
        "number": "123456"
    }
    
    # отправка запроса
    response = requests.post(
        url=url,
        params=params,
    )
    
    # преобразование ответа к словарю
    data = response.json()
                            
                        
                            
    using Newtonsoft.Json;
    class Program
    {
        static async Task Main(string[] args)
        {
            string end_point = "https://data.av100.org/creditrating.ashx";
    
            // Подготовка параметров get запроса по методу model1
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },
                { "method", "main" },
                { "mode", "queue" },
                { "lastname", "Иванов" },
                { "firstname", "Иван" },            
                { "birthdate", "1800-12-12" }, // не обязательно
                { "middlename", "Иванович" },
                { "series", "1234" },
                { "number", "123456" }
            };
    
            string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
            string url = $"{end_point}x?{url_params}";
    
            HttpClient client = new();
            string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();
    
            var result = JsonConvert.DeserializeObject(response_body);
        }
    }
                            
                        

    Результат вызова метода:

    Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Метод по которому формировался запрос
    mode String
    Режим работы мтеода. queue или result
    lastname String
    Фамилия по которой запрашивается информация
    firtsname String
    Имя по которой запрашивается информация
    middlename String
    Отчество по которой запрашивается информация
    birthdate String
    Дата рождения
    series String
    Серия паспорта
    number String
    Номер паспорта
    error Boolean
    Признак ошибки в запросе, имеет значение true в случае ошибки и false в случае её отсутствия
    result Object
    Объект с результатом возвращаемого запроса
    reportId String
    Идентификатор отчета

    Получение результата по методу main

    key
    Ключ доступа к API
    method
    Метод запроса (main)
    mode
    Режим работы метода (result)
    reportId
    Идентификатор отчета

    Примеры запроса:

    PHP
    Python
    C#
                            
    // Входные данные
    $url = "https://data.av100.org/creditrating.ashx";
    $request_params = array(
        "key" => "867983b5-d66d-44d7-b440-5bd00b0b8203",
        "method" => "main",
        "mode" => "result",
        "reportId" => "44511785-211f-4467-8817-519303111602"
    );
    
    $get_params = http_build_query($request_params);
    
    // Запрос к серверу
    $response = file_get_contents($url."?".$get_params);
    // Преобразование ответа
    $result = json_decode($response);
                            
                        
                            
    import requests
    
    url = "https://data.av100.org/creditrating.ashx"
    
    # подготовка параметров get запроса
    params = {
        "key": "867983b5-d66d-44d7-b440-5bd00b0b8203",    
        "method": "main",
        "mode": "result",
        "reportId": "44511785-211f-4467-8817-519303111602"
    }
    
    # отправка запроса
    response = requests.post(
        url=url,
        params=params,
    )
    
    # преобразование ответа к словарю
    data = response.json()
                            
                        
                            
    using Newtonsoft.Json;
    class Program
    {
        static async Task Main(string[] args)
        {
            string end_point = "https://data.av100.org/creditrating.ashx";
            Dictionary dict_params = new()
            {
                { "key", "867983b5-d66d-44d7-b440-5bd00b0b8203" },            
                { "method", "main" },
                { "mode", "result" }
                { "reportId", "44511785-211f-4467-8817-519303111602" }
            };
    
            string url_params = string.Join("&", dict_params.Select(kvp => $"{kvp.Key}={kvp.Value}"));
            string url = $"{end_point}?{url_params}";
    
            HttpClient client = new();
            string response_body = await client.GetAsync(url).Result.Content.ReadAsStringAsync();
    
            var result = JsonConvert.DeserializeObject(response_body);
        }
    }
                            
                        

    Результат вызова метода:

    Описание возвращаемого JSON

    start DateTime
    Дата и время создание запроса
    end DateTime
    Дата и время окончания запроса
    method String
    Метод по которому формировался запрос
    error String
    Признак ошибки в запросе, имеет значение true в случае ошибки и null в случае её отсутствия
    result Object
    Объект с результатом возвращаемого запроса
    id String
    Id запроса
    state Int
    0 - запрос на отчет создан 1 - запрос на отчет обрабатывается 2 - запрос на отчет обработан успешно 3 - запрос на отчет завершился ошибкой
    reportResultType Int
    Статус результата: 1 - успешно 2 - субъект не найден
    report
    updateDate Datetime
    Дата обновления
    score String
    Значение рейтинга субъекта. Чем больше рейтинг, тем надежнее субъект. Возможно спецзначение ""-1750" - У субъекта отсутствует кредитная история" (может указывать на отсутствие кредитов либо наличие только новых кредитов).
    factors Объект factors
    Факторы влияния на ввеличину рейтинга с указанием процента влияния.
    inquiries Объект inquiry
    Информация о запросах КИ субъекта.
    applications Объект applications
    Информация об обращении субъекта в кредитные организации с детализацией по одобрениям и отказам.
    lawsuits Int
    Информация о наличии судебных споров или требования по обязательству к субъекту.
    completedLawsuits Int
    Информация о судебных спорах, где вынесено судебное решение.
    bankruptcy Int
    Информация о стадии банкротства субъекта (при наличиии, см. справочник "Стадии Банкротства")
    capabilities Массив
    Информация о дееспособности субъекта (при наличиии, см. справочник "Виды дееспособности")
    сredits Объект credit
    Информация о кредитах

    Объект Factors

    type int
    Тип фактора (см. справочник "Факторы")
    weight int
    Вес фактора (процент)

    Объект Applications

    lastTwoWeeksApprovalCount int
    Кол-во обращений за последние 14 дней, одобрено
    lastTwoWeeksRejectCount int
    Кол-во обращений за последние 14 дней, отказано
    lastMonthApprovalCount int
    Кол-во обращений за последние 30 дней, одобрено
    lastMonthRejectCount int
    Кол-во обращений за последние 30 дней, отказано
    lastTwoMonthsApprovalCount int
    Кол-во обращений за последние 60 дней, одобрено
    lastTwoMonthsRejectCount int
    Кол-во обращений за последние 60 дней, отказано

    Объект Inquiry

    lastWeekCount int
    Кол-во обращений за последние 7 дней
    lastTwoWeeksCount int
    Кол-во обращений за последние 14 дней
    lastMonthCount int
    Кол-во обращений за последние 30 дней
    allTimeCount int
    Кол-во обращений всего

    Объект Credit

    worstOverdueForAllCredits перечисление Overdue
    Максимальный срок просрочки по всем кредитам
    worstOverdueForActiveCredits перечисление Overdue
    Максимальный срок просрочки по активным кредитам
    lastCreditCloseDate Datetime
    Год и месяц закрытия последнего кредита
    hasBadDebtOrPassedToCollection bool
    Безнадежный долг/передано на взыскание
    averagePayment Range decimal
    Размер среднего платежа по активным кредитам
    creditTypes массив объектов CreditTypeInfo
    Информация о типах кредитов
    activeCreditsOverdueAmountRange Range decimal
    cумма просрочки по активным кредитам
    activeCreditsLimitAmountRange Range decimal
    диапазон суммы активных кредитов
    activeCreditsCountRange Range int
    диапазон кол-ва активных кредитов
    activeCreditsAsGuaranteeCountRange Range int
    диапазон кол-ва счетов, где субъект выступает поручителем

    Объект CreditTypeInfo

    Open int
    1 - имеет открытые кредиты данного типа без просрочек 2 - имеет открытые кредиты данного типа с просрочкой 0 - не имеет открытых кредитов данного типа null - данные отсутствуют
    Closed int
    1 - имеет закрытые кредиты данного типа без просрочек 2 - имеет закрытые кредиты данного типа с просрочкой 0 - не имеет закрытых кредитов данного типа null - данные отсутствуют
    type int
    Справочник "Типы кредитов"

    Справочник Overdue

    0
    все неизвестные результаты
    1
    Оплата без просрочек
    2
    Просрочка от 1 до 7 дней
    3
    Просрочка от 8 до 29 дней
    4
    Просрочка от 1 до 29 дней
    5
    Просрочка от 30 до 59 дней
    6
    Просрочка от 60 до 89 дней
    7
    Просрочка от 90 до 119 дней
    8
    Просрочка от 120 до 179 дней
    9
    Просрочка более 180 дней

    Справочник Факторы

    1
    Просрочка исполнения обязательств
    2
    Размер просроченной задолженности
    3
    Период формирования КИ
    4
    Доля непогашенных требований по действующим обязательствам
    5
    Количество действующих и прекращенных обязательств перед финансовыми организациями
    6
    Множественность запросов кредитного отчета
    7
    Обращения с предложением совершить сделку в несколько организаций одновременно
    8
    Возраст субъекта
    9
    Иной фактор

    Справочник Виды дееспособности

    1
    Гражданин полностью дееспособен (в том числе если несовершеннолетний гражданин эмансипирован или вступил в брак)
    2
    Гражданин не полностью дееспособен в силу закона, в том числе в связи с несовершеннолетием
    3
    Суд ограничил дееспособность гражданина
    4
    Суд признал гражданина недееспособным
    5
    Суд признал гражданина дееспособным либо отменил ограничение дееспособности

    Справочник Стадии рассмотрения дела о банкротстве

    1
    Заявление о признании банкротом принято судом к производству
    2
    Реструктуризация долгов
    3
    Реализация имущества
    4
    Мировое соглашение
    5
    Производство по делу прекращено
    6
    Возбуждена процедура внесудебного банкротства
    7
    Завершена процедура внесудебного банкротства
    8
    Прекращена процедура внесудебного банкротства

    Справочник Типы кредитов

    1
    Ипотека
    2
    Потребительский
    3
    МФО
    4
    Автокредит
    5
    Кредитная карта
    6
    Кредит связанный с финансовой деятельностью
    7
    Кредит на образование
    8
    Другой залоговый кредит