Monitor Supplier

The Monitor Supplier endpoint allows you to retrieve contract information for a specific supplier identified by their INN (Individual Taxpayer Number).

Endpoint

GET https://api-v2.multitender.ru/contract/monitor-supplier44

Request Parameters

Parameter Name	Required	Description
`supplierINN`	Yes	Supplier’s INN (Individual Taxpayer Number)
`apikey`	Yes	Your API key
`format`	No	Response format (`xml` or `json`). Default: `xml`
`skip`	No	Starting record number (default: `0`)
`limit`	No	Number of records to return (default: `100`, maximum: `200`)

Request Examples

Get 100 contracts for a company

https://api-v2.multitender.ru/contract/monitor-supplier44?supplierInn=.....&apikey=.....

Get contracts from 200th to 400th

https://api-v2.multitender.ru/contract/monitor-supplier44?supplierInn=....&skip=200&limit=200&apikey=.....

Get contracts from 400th to 600th

https://api-v2.multitender.ru/contract/monitor-supplier44?supplierInn=....&skip=400&limit=200&apikey=.....

Response Structure

The response contains supplier information and a list of contracts. The structure varies slightly between XML and JSON formats.

XML
JSON

<response>
  <supplierINN>2360000401</supplierINN>
  <supplierIName>ООО "НОВОСТРОЙ"</supplierIName>
  <totalcount>79</totalcount>
  <skip>0</skip>
  <limit>200</limit>
  <contracts>
    <contract>
      <regNum>3234401380524000020</regNum>
      <purchaseNumber>0818600012224000291</purchaseNumber>
      <purchaseCode>243234401380523440100100220014329244</purchaseCode>
      <purchaseObjectInfo>Устройство ограждения площадки для КГО по ул. Толстого в ст. Новопокровской</purchaseObjectInfo>
      <notificationPrice>772465.68</notificationPrice>
      <deliveryTerm>2024-12-03+03:00</deliveryTerm>
      <customerInn>2344013805</customerInn>
      <customerName>АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ НОВОПОКРОВСКОГО РАЙОНА</customerName>
      <contractPrice>562851.86</contractPrice>
      <signDate>2024-08-27</signDate>
      <endDate>2024-12-03</endDate>
      <contractStage>EC</contractStage>
      <fulfilmentSum>551100</fulfilmentSum>
      <paid>
        <total>551100</total>
      </paid>
      <advanceInPercents>25.49</advanceInPercents>
      <penaltiesTotal>10354.14</penaltiesTotal>
      <penaltiesPayments>10354.14</penaltiesPayments>
      <ContractStages>1</ContractStages>
      <updateDate>2018-11-01</updateDate>
      <subContractors>true</subContractors>
      <subContractorsSum>1056640.80</subContractorsSum>
      <purchaseContractGuarantee>176106.8</purchaseContractGuarantee>
      <contractGuarantee>187854.1</contractGuarantee>
      <bankSupportContractRequired>false</bankSupportContractRequired>
      <treasurySupportContractRequired>false</treasurySupportContractRequired>
      <budgetName>Бюджет Фонда социального страхования Российской Федерации</budgetName>
      <OKTMO>04701000-город Красноярск</OKTMO>
      <products>
        <product>
          <code>85.11.16.211</code>
          <sum>481320</sum>
        </product>
      </products>
      <terminationBoth>false</terminationBoth>
      <terminationSupplier>false</terminationSupplier>
      <terminationCostomer>true</terminationCostomer>
      <terminationJudge>true</terminationJudge>
      <terminationCourt>false</terminationCourt>
      <bankGuaranteePayments>
        <bankGuaranteePayment>
          <paymentAmountRUR>502405.39</paymentAmountRUR>
          <publishDate>2015-10-14</publishDate>
          <requirementsDate>2015-09-24</requirementsDate>
          <improperExecInfo>Ненадлежащее исполнение поставщиком обязательств, предусмотренных контрактом в размере 0,5 % цены контракта</improperExecInfo>
        </bankGuaranteePayment>
      </bankGuaranteePayments>
    </contract>
  </contracts>
</response>

{
  "supplierINN": "2360000401",
  "supplierIName": "ООО \"НОВОСТРОЙ\"",
  "totalcount": 79,
  "skip": 0,
  "limit": 200,
  "contracts": [
    {
      "regNum": "3234401380524000020",
      "purchaseNumber": "0818600012224000291",
      "purchaseCode": "243234401380523440100100220014329244",
      "purchaseObjectInfo": "Устройство ограждения площадки для КГО по ул. Толстого в ст. Новопокровской",
      "notificationPrice": 772465.68,
      "deliveryTerm": "2024-12-03+03:00",
      "customerInn": "2344013805",
      "customerName": "АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ НОВОПОКРОВСКОГО РАЙОНА",
      "contractPrice": 562851.86,
      "signDate": "2024-08-27",
      "endDate": "2024-12-03",
      "contractStage": "EC",
      "fulfilmentSum": 551100,
      "paid": {
        "total": 551100
      },
      "advanceInPercents": 25.49,
      "penaltiesTotal": 10354.14,
      "penaltiesPayments": 10354.14,
      "ContractStages": 1,
      "updateDate": "2018-11-01",
      "subContractors": true,
      "subContractorsSum": 1056640.80,
      "purchaseContractGuarantee": 176106.8,
      "contractGuarantee": 187854.1,
      "bankSupportContractRequired": false,
      "treasurySupportContractRequired": false,
      "budgetName": "Бюджет Фонда социального страхования Российской Федерации",
      "OKTMO": "04701000-город Красноярск",
      "products": [
        {
          "code": "85.11.16.211",
          "sum": 481320
        }
      ],
      "terminationBoth": false,
      "terminationSupplier": false,
      "terminationCostomer": true,
      "terminationJudge": true,
      "terminationCourt": false,
      "bankGuaranteePayments": [
        {
          "paymentAmountRUR": 502405.39,
          "publishDate": "2015-10-14",
          "requirementsDate": "2015-09-24",
          "improperExecInfo": "Ненадлежащее исполнение поставщиком обязательств, предусмотренных контрактом в размере 0,5 % цены контракта"
        }
      ]
    }
  ]
}

Response Fields

Root Level Fields

Field	Type	Required	Description	Example
`supplierINN`	string	Yes	Supplier’s INN	`2360000401`
`supplierIName`	string	Yes	Supplier name	`ООО "НОВОСТРОЙ"`
`totalcount`	int	Yes	Total number of contracts found	`79`
`skip`	int	Yes	Starting record number	`0`
`limit`	int	Yes	Number of records returned	`200`
`contracts`	array	Yes	List of contracts (may be empty)	-

Contract Fields

Field	Type	Required	Description	Example
`regNum`	string	Yes	Contract number, link to EIS	`3234401380524000020`
`purchaseNumber`	string	No	Purchase number, link to EIS	`0818600012224000291`
`purchaseCode`	string	No	Purchase identification code (IKZ)	`243234401380523440100100220014329244`
`purchaseObjectInfo`	string	No	Contract subject / Purchase object	`Устройство ограждения площадки для КГО по ул. Толстого в ст. Новопокровской`
`notificationPrice`	float	No	Initial maximum contract price (NMCC), RUB	`772465.68`
`deliveryTerm`	string	No	Contract execution term	`2024-12-03+03:00`
`customerInn`	string	Yes	Customer’s INN	`2344013805`
`customerName`	string	Yes	Customer name	`АДМИНИСТРАЦИЯ НОВОПОКРОВСКОГО СЕЛЬСКОГО ПОСЕЛЕНИЯ НОВОПОКРОВСКОГО РАЙОНА`
`contractPrice`	float	No	Contract price, RUB	`562851.86`
`signDate`	date (YYYY-MM-DD)	Yes	Contract signing date	`2024-08-27`
`endDate`	date (YYYY-MM-DD)	No	Contract execution end date	`2024-12-03`
`contractStage`	string	Yes	Contract status. Possible values: `EC` (execution completed), `ET` (execution terminated), `E` (in execution), `IN` (registry entry annulled)	`EC`
`fulfilmentSum`	float	No	Cost of fulfilled obligations, RUB	`551100`
`paid.total`	float	No	Actually paid, RUB	`551100`
`advanceInPercents`	float	No	Advance payment, %	`25.49`
`penaltiesTotal`	float	No	Penalties, RUB	`10354.14`
`penaltiesPayments`	float	No	Penalty payments, RUB	`10354.14`
`ContractStages`	int	Yes	Number of stages	`1`
`updateDate`	date (YYYY-MM-DD)	Yes	Last update date	`2018-11-01`
`subContractors`	boolean	Yes	Subcontractor involvement in contract execution	`true`
`subContractorsSum`	float	Yes	Subcontractor involvement volume, RUB	`1056640.80`
`purchaseContractGuarantee`	float	No	Performance guarantee amount from purchase, RUB	`176106.8`
`contractGuarantee`	float	No	Performance guarantee amount from contract, RUB	`187854.1`
`bankSupportContractRequired`	boolean	Yes	Bank support required	`false`
`treasurySupportContractRequired`	boolean	Yes	Treasury support required	`false`
`budgetName`	string	No	Budget	`Бюджет Фонда социального страхования Российской Федерации`
`OKTMO`	string	No	Territory code	`04701000-город Красноярск`
`products`	array	No	Contract items	-
`products[].code`	string	No	Position by KTRU, OKPD2	`85.11.16.211`
`products[].sum`	float	No	Item amount	`481320`
`terminationBoth`	boolean	Yes	Contracts terminated by mutual agreement, RUB	`false`
`terminationSupplier`	boolean	Yes	Contracts terminated by supplier’s unilateral refusal, RUB	`false`
`terminationCostomer`	boolean	Yes	Contracts terminated by customer’s unilateral refusal, RUB	`true`
`terminationJudge`	boolean	Yes	Contracts terminated by court decision, RUB	`true`
`terminationCourt`	boolean	Yes	Contracts terminated for unknown reason, RUB	`false`
`bankGuaranteePayments`	array	No	Bank guarantee claims	-
`bankGuaranteePayments[].paymentAmountRUR`	float	No	Claim amount, RUB	`502405.39`
`bankGuaranteePayments[].publishDate`	date (YYYY-MM-DD)	No	Claim publication date	`2015-10-14`
`bankGuaranteePayments[].requirementsDate`	date (YYYY-MM-DD)	No	Claim date	`2015-09-24`
`bankGuaranteePayments[].improperExecInfo`	string	No	Claim basis	`Ненадлежащее исполнение поставщиком обязательств, предусмотренных контрактом в размере 0,5 % цены контракта`

Error Codes

The API always returns HTTP status code 200 unless there are fatal server errors (e.g., 404).

Invalid API Key

Error Code: 401

Response: Некорректный API_KEY.

Limit Exceeded

Error Code: 400

Response: Превышен лимит контрактов ... Разрешено ... макс.

This error occurs when the limit parameter exceeds the maximum allowed value of 200.

Server Error

When server errors occur during data processing:

XML Format:

<data>
  <error>server error</error>
</data>

JSON Format:

{
  "error": "server error"
}

Empty Values

Empty fields are handled differently depending on the response format:

XML Format: Empty fields appear as self-closing tags, e.g., <paidTotal/>
JSON Format: Empty fields are set to null, e.g., "paidTotal": null

Multitender.ru