Welcome to openregistry.lots.loki’s documentation!

Please report any problems or suggestions for improvement either via the mailing list or the issue tracker.

Contents:

Overview

openregistry.lots.loki contains the description of the Lots Registry.

Features

  • Lot represents the finalized object to be privatized within the process.
  • One asset only may be included in a single lot.
  • Asset which is included in lot, marked as attached to it and can’t be used for other lots formation.
  • Lot can be deleted only in case of documentType: cancellationDetails has been attached.
  • Time for the lot to be edited is rectificationPeriod.

Conventions

API accepts JSON or form-encoded content in requests. It returns JSON content in all of its responses, including errors. Only the UTF-8 character encoding is supported for both requests and responses.

All API POST and PUT requests expect a top-level object with a single element in it named data. Successful responses will mirror this format. The data element should itself be an object, containing the parameters for the request.

If the request was successful, we will get a response code of 201 indicating the object was created. That response will have a data field at its top level, which will contain complete information on the new lot, including its ID.

If something went wrong during the request, we’ll get a different status code and the JSON returned will have an errors field at the top level containing a list of problems. We look at the first one and print out its message.


Project status

The project has pre alpha status.

The source repository for this project is on GitHub: https://github.com/openprocurement/openregistry.lots.loki

API stability

API is relatively stable. The changes in the API are communicated via Open Procurement API maillist.

Next steps

You might find it helpful to look at the Tutorial.

Data Standard

Data standard is modelled along the Open Contracting Standard with extensions in areas that were not covered by it.

Lot

Schema

id:

uuid, auto-generated, read-only

Internal identifier for this lot.

lotID:

string, auto-generated, read-only

The lot identifier to refer that lot to in the paper documentation.

OpenContracting Description: LotID is included to make the flattened data structure more convenient.

owner:

string, auto-generated, read-only

The entity whom the lot is owned by.

date:

string, auto-generated, read-only

The date of lot creation/undoing.

title:

string, multilingual, required

  • Ukrainian by default (required) - Ukrainian title
  • title_en (English) - English title
  • title_ru (Russian) - Russian title

Oprionally can be mentioned in English/Russian.

Initial data originates from asset.title.

description:

string, multilingual, required

OpenContracting Description: A description of the goods, services to be provided.

  • Ukrainian by default - Ukrainian decription
  • decription_en (English) - English decription
  • decription_ru (Russian) - Russian decription

Initial data originates from asset.description.

dateModified:

string, auto-generated, read-only

OpenContracting Description: Date when the lot was last modified.

status:

string, required

The lot status within the Registry.

Status Description
draft:
Lot created but not yet available
composing:
Attachment of the asset to the lot
verification:
Asset availability check
pending:
Editing the lot
invalid:
If the lot is incorrectly created
active.salable:
Expecting the start of the auction
pending.deleted:
 
Separating the asset
deleted:
Delete a lot
active.auction:
Holding an auction by lot
active.contracting:
 
Contracting process
pending.sold:
Separating the asset. Lot sold
sold:
Lot sold
pending.dissolution:
 
Separating the asset
dissolved:
Dissolution lot
relatedProcesses:
 

Array of Related Processes

Block containing information about the relation to objects beyond the lot.

decisions:

Array of Decisions, required

Also include the data from asset.decisions.

lotCustodian:

Organization, required

An entity managing the lot. Initial data originates from asset.assetCustodian.

items:

Array of Item, required

Initial data originates from asset.items.

lotHolder:

Organization, required

Initial data originates from asset.assetHolder.

rectificationPeriod:
 

Period, auto-generated, read-only

Period during which the lot’s owner can edit it.

auctions:

Array of Auction, required

Auction conditions due to which the lot is to be sold.

documents:

Array of Documents objects

OpenContracting Description: All documents and attachments related to the lot.

mode:

string, optional

The additional parameter with a value test.

sandboxParameters:
 

string, optional

Parameter that accelerates lot periods. Set quick, accelerator=1440 as text value for sandboxParameters for the time frames to be reduced in 1440 times.

lotType:

string, auto-generated, read-only

Type of the given lot. Given value:

  • yoke - lotType for the small scale privatization process.

Period

Schema

startDate:

string, Date

OpenContracting Description: The start date for the period. startDate should always precede endDate.

endDate:

string, Date

OpenContracting Description: The end date for the period.

Date

Date/time in ISO 8601.

Value

Schema

amount:

float, required

Should be positive.

currency:

string, required

OpenContracting Description: The currency in 3-letter ISO 4217 format.

valueAddedTaxIncluded:
 

bool, required

Possible values are true or false.

Decisions

Schema

title:

string, multilingual, optional

  • Ukrainian by default (optional) - Ukrainian title
  • title_en (English) - English title
  • title_ru (Russian) - Russian title
decisionDate:

Date, required

OpenContracting Description: The date on which the document was first published.

decisionID:

string, required

The decision identifier to refer to in the paper documentation.

decisionOf:

string, required

Possible values are:

  • lot
  • asset
relatedItem:

string, auto-generated

Internal id of related asset.

Сontracts

Schema

type:

string, auto-generated, read-only

Type of the contract. The only value is yoke.

id:

uuid, auto-generated, read-only

Internal identifier of the object within the Module of Contracting.

Added as long as the contract is being created within the Module of Contracting.

status:

string, auto-generated, read-only

Status of contract within the Module of Contracting.

Added as long as the contract is being created within the Module of Contracting.

Auction

Schema

id:

string, auto-generated, read-only

auctionID:

string, auto-generated, read-only

The auction identifier to refer auction to in “paper” documentation.

OpenContracting Description: It is included to make the flattened data structure more convenient.

procurementMethodType:
 

string, auto-generated, read-only

Type that defines what type of the procedure is going to be used. Possible values:

  • sellout.english - procedure with the open ascending price auction;
  • sellout.insider - procedure with the insider auction.
procurementMethodDetails:
 

string, optional

Parameter that accelerates auction periods. Set quick, accelerator=1440 as text value for procurementMethodDetails for the time frames to be reduced in 1440 times.

submissionMethodDetails:
 

string, optional

Parameter that works only with mode = “test” and speeds up auction start date.

Possible value is quick.

sandboxParameters:
 

string, optional

Parameter that accelerates lot periods. Set quick, accelerator=1440 as text value for sandboxParameters for the time frames to be reduced in 1440 times.

auctionPeriod:

Period, required

Period when the first auction is conducted. Here only startDate has be provided.

tenderingDuration:
 

Duration, required

Duration of tenderPeriod for 2nd and 3rd procedures within the privatization cycle.

documents:

Array of Documents objects, optional

OpenContracting Description: All documents and attachments related to the auction.

value:

Value, required

Total available budget of the 1st auction. Bids lower than value will be rejected.

Auction.value for 2nd and 3rd auctions within the privatization cycle will be calculated as half of the auction.value provided.

OpenContracting Description: The total estimated value of the procurement.

guarantee:

Guarantee, required

Bid guarantee. Lots.auctions.guarantee for 2nd and 3rd auctions within the privatization cycle will be calculated auctomatically.

registrationFee:
 

Guarantee, required

Bid registration fee. Lots.auctions.registrationFee for 2nd and 3rd auctions within the privatization cycle will be calculated auctomatically.

minimalStep:

Value, required

The minimal step of the 1st auction. Lots.auctions.minimalStep for 2nd and 3rd auctions within the privatization cycle will be calculated auctomatically.

auctionParameters:
 

Auction Parameters, optional

Parameters for the auction to be held.

Ogranizator can optionally set value for the 3rd auction within the lots.auctions structure.

bankAccount:

Bank Account, required

Details which uniquely identify a bank account, and are used when making or receiving a payment.

tenderAttempts:

integer, auto-generated, read-only

The number which represents what time (from 1 up to 3) procedure with a current lot takes place.

status:

string, required

Auction status within which the lot is being sold:

Status Description
scheduled

The process is planned, but is not yet taking place.

Details of the anticipated dates may be provided further

active The process is currently taking place
complete The process is complete;
cancelled The process has been cancelled;
unsuccessful The process has been unsuccessful.
  • unsuccessful - the process has been unsuccessful.
contracts:

Array of Сontracts, auto-generated, read-only

Information of the related contract.

relatedProcessID:
 

uuid, required

Internal id of the auction.

Auction Parameters

Schema

type:

string, auto-generated, read-only

Type of the auction.

dutchSteps:

integer, required for the third auction

Number of steps within the dutch part of the insider auction.

Possible values are [1; 100]. Defaul value is 99.

Duration

Duration in ISO 8601.

Value

Schema

amount:

float, required

Should be positive.

OpenContracting Description: Amount as a number.

currency:

string, required

OpenContracting Description: The currency in 3-letter ISO 4217 format.

valueAddedTaxIncluded:
 

bool, required

Possible values are true or false.

Guarantee

Schema

amount:

float, required

Should be positive.

OpenContracting Description: Amount as a number.

currency:

string, required

OpenContracting Description: The currency in 3-letter ISO 4217 format.

Bank Account

Schema

description:

string, multilingual, optional

Additional information that has to be noted from the Organizator’s point.

bankName:

string, required

Name of the bank.

accountIdentification:
 

Array of Classification, required

Major data on the account details of the state entity selling a lot, to facilitate payments at the end of the process.

Most frequently used are:

  • UA-EDR;
  • UA-MFO;
  • accountNumber.

Сontracts

Schema

type:

string, required, auto-generated, read-only

Type of the contract. The only value is yoke.

contractID:

string, required, auto-generated, read-only

The contract identifier to refer to in “paper” documentation.

Added as long as the contract is being created within the Module of Contracting.

relatedProcessID:
 

uuid, required, auto-generated, read-only

Internal identifier of the object within the Module of Contracting.

Added as long as the contract is being created within the Module of Contracting.

Organization

Schema

name:

string, multilingual, required

Name of the organization.

identifier:

Identifier, required

The primary identifier for this organization.

additionalIdentifiers:
 

List of Identifier, optional

address:

Address, required for lotCustodian

contactPoint:

ContactPoint, required for lotCustodian

additionalContactPoints:
 

Array of ContactPoint, optional

kind:

string, optional

Type of the organizer. Available only for lotCustodian.

Possible values:
  • general - Organizer (general)
  • special - Organizer that operates in certain spheres of economic activity
  • other - Legal persons that are not organizers in the sense of the Law, but are state, utility, public enterprises, economic partnerships or associations of enterprises in which state or public utility share is 50 percent or more

Identifier

Schema

scheme:

string, required

OpenContracting Description: Organization identifiers be drawn from an existing identification scheme. This field is used to indicate the scheme or codelist in which the identifier will be found. This value should be drawn from the Organization Identifier Scheme.

id:

string, required

OpenContracting Description: The identifier of the organization in the selected scheme.

The allowed codes are the ones found in “Organisation Registration Agency” codelist of IATI Standard with addition of UA-EDR code for organizations registered in Ukraine (EDRPOU and IPN).

legalName:

string, multilingual, optional

OpenContracting Description: The legally registered name of the organization.

Full legal name (e.g. Nadra Bank).

uri:

uri, optional

OpenContracting Description: A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the url field of the Organization contact point.

Address

Schema

streetAddress:

string, optional

OpenContracting Description: The street address. For example, 1600 Amphitheatre Pkwy.

locality:

string, optional

OpenContracting Description: The locality. For example, Mountain View.

region:

string, optional

OpenContracting Description: The region. For example, CA.

postalCode:

string, optional

OpenContracting Description: The postal code. For example, 94043.

countryName:

string, multilingual, required

OpenContracting Description: The country name. For example, United States.

ContactPoint

Schema

name:

string, multilingual, required

OpenContracting Description: The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

email:

email

OpenContracting Description: The e-mail address of the contact point/person.

telephone:

string

OpenContracting Description: The telephone number of the contact point/person. This should include the international dialling code.

faxNumber:

string, optional

OpenContracting Description: The fax number of the contact point/person. This should include the international dialling code.

url:

URL, optional

OpenContracting Description: A web address for the contact point/person.

Either email or telephone field has to be provided.

Item

Schema

id:

uuid, auto-generated, read-only

Internal identifier for this item.

description:

string, multilingual, required

OpenContracting Description: A description of the goods, services to be provided.

Auction subject / asset description.

classification:

Classification, required

OpenContracting Description: The primary classification for the item. See the itemClassificationScheme to identify preferred classification lists, including CAV and GSIN.

It is required for classification.scheme to be CPV or CAV-PS. The classification.id should be valid CPV or CAV-PS code.

The CPV & CAV-PS codes accuracy should be equal to the class (XXXX0000-Y) at least.

additionalClassifications:
 

Array of Classification, optional

OpenContracting Description: An array of additional classifications for the item. See the itemClassificationScheme codelist for common options to use in OCDS. This may also be used to present codes from an internal classification scheme.

E.g.`CPVS`, DK018, cadastralNumber & UA-EDR can be chosen from the list. The codes are to be noted manually for cadastralNumber & UA-EDR.

unit:

Unit, required

OpenContracting Description: Description of the unit which the good comes in e.g. hours, kilograms. Made up of a unit name, and the value of a single unit.

quantity:

decimal, required

OpenContracting Description: The number of units required.

address:

Address, required

Address, where the item is located.

location:

dictionary, optional

Geographical coordinates of the location. Element consists of the following items:

latitude:string, required;
longitude:string, required;
elevation:string, optional, usually not used.

location usually takes precedence over address if both are present.

registrationDetails:
 

Registration Details, required

Registration Details

Schema

status:

string, required

Possible values are:

unknown:default value;
registering:item is still registering;
complete:item has already been registered.
registrationID:

string, optional

The document identifier to refer to in the paper documentation.

Available for mentioning in status: complete.

registrationDate:
 

Date, optional

OpenContracting Description: The date on which the document was first published.

Available for mentioning in status: complete.

Classification

Schema

scheme:

string, required

OpenContracting Description: A classification should be drawn from an existing scheme or list of codes. This field is used to indicate the scheme/codelist from which the classification is drawn. For line item classifications, this value should represent a known Item Classification Scheme wherever possible.

id:

string, required

OpenContracting Description: The classification code drawn from the selected scheme.

description:

string, required

OpenContracting Description: A textual description or title for the code.

uri:

uri, optional

OpenContracting Description: A URI to identify the code. In the event individual URIs are not available for items in the identifier scheme this value should be left blank.

Unit

Schema

code:

string, required

UN/CEFACT Recommendation 20 unit code.

name:

string, optional

OpenContracting Description: Name of the unit

Lot Holder

Schema

name:

string, multilingual, required

Name of the entity.

identifier:

Identifier, required

The primary identifier for this entity.

additionalIdentifiers:
 

Array of Identifier objects

address:

Address, optional

contactPoint:

ContactPoint, optional

additionalContactPoints:
 

Array of ContactPoint, optional

Documents

Schema

id:

string, auto-generated, read-only

Internal identifier of the object within an array.

documentType:

string, required

Type of the document.

Possible values are:

  • notice - Lot Notice

The formal notice that gives details. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • technicalSpecifications - Technical Specifications

Detailed technical information about goods or services to be provided.

  • illustration - Illustrations
  • x_presentation - Presentation

Presentation about the lot to be sold.

  • informationDetails - Information Details

Auto-generated type of document that will be attached to each of the lot automatically.

  • cancellationDetails - Cancellation Details

Reasons why the lot has to be deleted.

Note: The following are specific for Auction only:

  • evaluationCriteria - Evaluation Criteria

Information about how bids will be evaluated.

  • x_PublicAssetCertificate - Public Asset Certificate

Information about the auction. It is a link to the Public Asset Certificate.

  • x_PlatformLegalDetails - Platform Legal Details

Place and application forms for participation in the auction as well as bank details for transferring guarantee deposits.

  • bidders - Information on bidders

Information on bidders or participants, their validation documents and any procedural exemptions for which they qualify.

  • x_nda - Non-disclosure Agreement (NDA)

A non-disclosure agreement between a participant and a bank.

  • x_dgfAssetFamiliarization - Asset Familiarization

Goods examination procedure rules / Asset familiarization procedure in data room. Contains information on where and when a given document can be examined offline.

title:

string, multilingual, required

OpenContracting Description: The document title.

description:

string, multilingual, optional

OpenContracting Description: A short description of the document. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

format:

string, optional

OpenContracting Description: The format of the document taken from the IANA Media Types code list, with the addition of one extra value for ‘offline/print’, used when this document entry is being used to describe the offline publication of a document.

url:

string, auto-generated, read-only

OpenContracting Description: Direct link to the document or attachment.

datePublished:

Date, auto-generated, read-only

OpenContracting Description: The date on which the document was first published.

dateModified:

Date, auto-generated, read-only

OpenContracting Description: Date that the document was last modified

language:

string, optional

OpenContracting Description: Specifies the language of the linked document using either two-digit ISO 639-1, or extended BCP47 language tags.

documentOf:

string, required

Possible values are:

  • lot
  • item
relatedItem:

string, optional

Internal id of related Lot or Item.

index:

integer, optional

OpenContracting Description: Sorting (display order) parameter used for illustrations. The smaller number is, the higher illustration is in the sorting. If index is not specified, illustration will be displayed the last. If two illustrations have the same index, they will be sorted depending on their publishing date.

accessDetails:

string, optional

Required for x_dgfAssetFamiliarization document.

Lots Workflow

digraph G {
        subgraph cluster_1 {
                node [style=filled, fillcolor=seashell2];
                edge[style=dashed,  arrowhead="vee"];
                "draft" -> "composing" [color="0.6667 1.0000 0.5020"];
                edge[style=dashed,  arrowhead="vee"];
                "composing" -> "verification" [color="0.6667 1.0000 0.5020"];
                edge[style=solid,  arrowhead="vee"];
                "verification" -> "pending" [color="0.6667 1.0000 0.5020"];
                edge[style=solid,  arrowhead="vee"];
                "pending" -> "active.salable" [color="0.6667 1.0000 0.5020"];
                edge[style=solid,  dir="both"];
                "active.salable" -> "active.auction" [color="0.6667 1.0000 0.5020"];
                edge[dir="forward"];
                "active.auction" -> "active.contracting" [color="0.6667 1.0000 0.5020"];
                edge[dir="forward"];
                "active.contracting" -> "pending.sold" [color="0.6667 1.0000 0.5020"];
                edge[dir="forward"];
                "pending.sold" -> "sold" [color="0.6667 1.0000 0.5020"];
                color=white;
        }

        edge[style=solid, arrowhead="vee"]
        "verification" -> "invalid" [color="0.0000 0.0000 0.3882"];
        edge[style=dashed, arrowhead="vee"]
        "pending" -> "pending.deleted" [color="0.0000 0.0000 0.3882"];
        edge[style=solid, arrowhead="vee"]
        "pending.deleted" -> "deleted" [color="0.0000 0.0000 0.3882"];
        edge[style=solid];
        node [style=solid];
        edge[style=solid];
        "active.auction" -> "pending.dissolution" [color="0.0000 0.0000 0.3882"];
        edge[style=solid];
        "active.contracting" -> "pending.dissolution" [color="0.0000 0.0000 0.3882"];
        edge[style=solid];
        node [style=solid];
        "pending.dissolution" -> "dissolved" [color="0.0000 0.0000 0.3882"];
}

Legend

  • dashed line - user action
  • solid line - action is done automatically

Tutorial

Exploring basic rules

Let’s try exploring the /lots endpoint:

GET /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/2.5/lots?offset=", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots?offset=", 
    "offset": ""
  }, 
  "data": []
}

Just invoking it reveals empty set.

Now let’s attempt creating a lot:

POST /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 415 Unsupported Media Type
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error", 
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']", 
      "location": "header", 
      "name": "Content-Type"
    }
  ]
}

Error states that the only accepted Content-Type is application/json.

Let’s satisfy the Content-type requirement:

POST /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error", 
  "errors": [
    {
      "description": "Expecting value: line 1 column 1 (char 0)", 
      "location": "body", 
      "name": "data"
    }
  ]
}

Error states that no data has been found in JSON body.

Creating lot

You can create lot with relatedProcesses at once. It`s called a batch mode.

POST /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 415
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID"
      }
    ], 
    "lotType": "loki", 
    "relatedProcesses": [
      {
        "type": "asset", 
        "relatedProcessID": "ea369adce3f04fa8acc8fcd1afa953c4"
      }
    ], 
    "description": "Щось там тестове", 
    "title": "Тестовий лот"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots/082937c0a9a943e6a66002f38d8ab164
X-Content-Type-Options: nosniff
{
  "access": {
    "transfer": "91e654db1f7d494c85e264a5f30d94b9", 
    "token": "c4cfb45bcafc4e79a3b534602a96e697"
  }, 
  "data": {
    "status": "draft", 
    "lotID": "UA-LR-DGF-2019-02-04-000001", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "35ae4e36b10147e6a6ca4b0e314f654b"
      }
    ], 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "bfeb1c6300c842798e53866e615d3f06", 
        "decisionOf": "lot"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.554481+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.542498+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.542517+02:00", 
        "id": "6e14c66ae6774154a65580093cad49be"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "8912e301d220436297bfee78d1c98f50", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "599d9e97d8e64c60aa8412e59815bda0", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "71ccc567557a4837a1a43565db8653d9", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.552130+02:00", 
    "relatedProcesses": [
      {
        "type": "asset", 
        "id": "be09ce96c69a45a9bc419b0ba180392b", 
        "relatedProcessID": "ea369adce3f04fa8acc8fcd1afa953c4"
      }
    ], 
    "id": "082937c0a9a943e6a66002f38d8ab164"
  }
}

Let’s create lot with the minimal data set:

POST /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 318
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "lotType": "loki", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID"
      }
    ], 
    "description": "Щось там тестове", 
    "title": "Тестовий лот"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9
X-Content-Type-Options: nosniff
{
  "access": {
    "transfer": "4f25bf3567104b9db6efb41a3b539fa3", 
    "token": "f3e126c1e7734b1b8887cfbf17478baa"
  }, 
  "data": {
    "status": "draft", 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "1f33640dca2f43b48787d5bceacb577a"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.596837+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.586506+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.586543+02:00", 
        "id": "fa6b62b6f5e2400d963dd502d2d83623"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "11f0bee4cf814e36b91ede32155fce67", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "ec32cd417be24997af164a661733756d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "fe87453d392845819b75c11d66cc414d", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.594789+02:00", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "5d1a237b9525459d9262153c5ae5cb5f", 
        "decisionOf": "lot"
      }
    ], 
    "id": "962fa6efd16d4d55acd4b1f88bb7cec9"
  }
}

The object you’re trying to add initially receives draft status. You should manually switch this object from draft to composing (2 Phase Commit mechanism) so that to add the auction conditions (value.amount, minimalStep.amount, etc.):

PATCH /api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9?acc_token=f3e126c1e7734b1b8887cfbf17478baa HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "composing"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "composing", 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "1f33640dca2f43b48787d5bceacb577a"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.667210+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.586506+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.586543+02:00", 
        "id": "fa6b62b6f5e2400d963dd502d2d83623"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "11f0bee4cf814e36b91ede32155fce67", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "ec32cd417be24997af164a661733756d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "fe87453d392845819b75c11d66cc414d", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.667036+02:00", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "5d1a237b9525459d9262153c5ae5cb5f", 
        "decisionOf": "lot"
      }
    ], 
    "id": "962fa6efd16d4d55acd4b1f88bb7cec9"
  }
}

You see that lot.auctions structure has been added with the set of auto-generated data.

Now let’s add extra auction conditions. Note that the information is being added to each of three auctions one by one:

PATCH /api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9/auctions/11f0bee4cf814e36b91ede32155fce67 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 507
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
X-Access-Token: f3e126c1e7734b1b8887cfbf17478baa
DATA:
{
  "data": {
    "bankAccount": {
      "accountIdentification": [
        {
          "scheme": "accountNumber", 
          "id": "111111-8", 
          "description": "some description"
        }
      ], 
      "bankName": "name of bank"
    }, 
    "minimalStep": {
      "currency": "UAH", 
      "amount": 300.87, 
      "valueAddedTaxIncluded": true
    }, 
    "auctionPeriod": {
      "startDate": "2019-02-08T16:43:16.610865+02:00"
    }, 
    "registrationFee": {
      "currency": "UAH", 
      "amount": 700.87
    }, 
    "value": {
      "currency": "UAH", 
      "amount": 3000.87, 
      "valueAddedTaxIncluded": true
    }, 
    "guarantee": {
      "currency": "UAH", 
      "amount": 700.87
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "scheduled", 
    "bankAccount": {
      "accountIdentification": [
        {
          "scheme": "accountNumber", 
          "id": "111111-8", 
          "description": "some description"
        }
      ], 
      "bankName": "name of bank"
    }, 
    "minimalStep": {
      "currency": "UAH", 
      "amount": 300.87, 
      "valueAddedTaxIncluded": true
    }, 
    "auctionPeriod": {
      "startDate": "2019-02-08T16:43:16.610865+02:00"
    }, 
    "registrationFee": {
      "currency": "UAH", 
      "amount": 700.87
    }, 
    "procurementMethodType": "sellout.english", 
    "value": {
      "currency": "UAH", 
      "amount": 3000.87, 
      "valueAddedTaxIncluded": true
    }, 
    "id": "11f0bee4cf814e36b91ede32155fce67", 
    "auctionParameters": {
      "type": "english"
    }, 
    "tenderAttempts": 1, 
    "guarantee": {
      "currency": "UAH", 
      "amount": 700.87
    }
  }
}
PATCH /api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9/auctions/ec32cd417be24997af164a661733756d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
X-Access-Token: f3e126c1e7734b1b8887cfbf17478baa
DATA:
{
  "data": {
    "tenderingDuration": "P25DT12H"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "scheduled", 
    "bankAccount": {
      "accountIdentification": [
        {
          "scheme": "accountNumber", 
          "id": "111111-8", 
          "description": "some description"
        }
      ], 
      "bankName": "name of bank"
    }, 
    "minimalStep": {
      "currency": "UAH", 
      "amount": 150.44, 
      "valueAddedTaxIncluded": true
    }, 
    "registrationFee": {
      "currency": "UAH", 
      "amount": 700.87
    }, 
    "procurementMethodType": "sellout.english", 
    "value": {
      "currency": "UAH", 
      "amount": 1500.44, 
      "valueAddedTaxIncluded": true
    }, 
    "tenderingDuration": "P25DT12H", 
    "id": "ec32cd417be24997af164a661733756d", 
    "auctionParameters": {
      "type": "english"
    }, 
    "tenderAttempts": 2, 
    "guarantee": {
      "currency": "UAH", 
      "amount": 350.44
    }
  }
}

Now let’s add relatedProcesses:

POST /api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9/related_processes HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 83
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
X-Access-Token: f3e126c1e7734b1b8887cfbf17478baa
DATA:
{
  "data": {
    "type": "asset", 
    "relatedProcessID": "a9cbac9550db413284dcfbbf9f9cd028"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9/related_processes/c9dd31ba70cf485fa30231f3a19a81dc
X-Content-Type-Options: nosniff
{
  "data": {
    "type": "asset", 
    "id": "c9dd31ba70cf485fa30231f3a19a81dc", 
    "relatedProcessID": "a9cbac9550db413284dcfbbf9f9cd028"
  }
}

To enable further manipulations with the lot, its status should be manually switched to verification.

PATCH /api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9?acc_token=f3e126c1e7734b1b8887cfbf17478baa HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "verification"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "verification", 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "1f33640dca2f43b48787d5bceacb577a"
      }
    ], 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "5d1a237b9525459d9262153c5ae5cb5f", 
        "decisionOf": "lot"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.878755+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.586506+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.586543+02:00", 
        "id": "fa6b62b6f5e2400d963dd502d2d83623"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "11f0bee4cf814e36b91ede32155fce67", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ec32cd417be24997af164a661733756d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "fe87453d392845819b75c11d66cc414d", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.878582+02:00", 
    "relatedProcesses": [
      {
        "type": "asset", 
        "id": "c9dd31ba70cf485fa30231f3a19a81dc", 
        "relatedProcessID": "a9cbac9550db413284dcfbbf9f9cd028"
      }
    ], 
    "id": "962fa6efd16d4d55acd4b1f88bb7cec9"
  }
}

Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created asset: its internal id (that matches the Location segment), its official assetID and dateModified datestamp stating the moment when asset was last modified. Note that lot is created with pending status.

Let’s access the URL of the created object (the Location header of the response):

We can see the same response we got after creating lot.

POST /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 318
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "lotType": "loki", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID"
      }
    ], 
    "description": "Щось там тестове", 
    "title": "Тестовий лот"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9
X-Content-Type-Options: nosniff
{
  "access": {
    "transfer": "4f25bf3567104b9db6efb41a3b539fa3", 
    "token": "f3e126c1e7734b1b8887cfbf17478baa"
  }, 
  "data": {
    "status": "draft", 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "1f33640dca2f43b48787d5bceacb577a"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.596837+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.586506+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.586543+02:00", 
        "id": "fa6b62b6f5e2400d963dd502d2d83623"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "11f0bee4cf814e36b91ede32155fce67", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "ec32cd417be24997af164a661733756d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "fe87453d392845819b75c11d66cc414d", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.594789+02:00", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "5d1a237b9525459d9262153c5ae5cb5f", 
        "decisionOf": "lot"
      }
    ], 
    "id": "962fa6efd16d4d55acd4b1f88bb7cec9"
  }
}

Let’s see what listing of lots reveals us:

GET /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/2.5/lots?offset=", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots?offset=", 
    "offset": ""
  }, 
  "data": []
}

We do see the internal id of the lot (that can be used to construct full URL http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/lots/8286cc7863814271afe23cb2646237ed`) and its dateModified date stamp.

Let’s try creating another lot:

POST /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 318
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "lotType": "loki", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID"
      }
    ], 
    "description": "Щось там тестове", 
    "title": "Тестовий лот"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots/29375080d5f3421fb11090fe1ca95c0c
X-Content-Type-Options: nosniff
{
  "access": {
    "transfer": "1a287c915e4047248e37a20d5d57a55e", 
    "token": "451959c45b204676a31d5dd8fe55263e"
  }, 
  "data": {
    "status": "draft", 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "2a1a633741414cdab85c365ca07f8467"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.936612+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.924753+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.924773+02:00", 
        "id": "ea6dbf0b0ad949f3b11d1d176d28bfd2"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "560c1259b99746cabf29bcd49e4aef4b", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "911bcc72c129493f949d7180a2c4403d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "5613b60b61bf4e4a91d1eb286df65a62", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.933475+02:00", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "d18bf1ea75c84991b3da9121ed7dc520", 
        "decisionOf": "lot"
      }
    ], 
    "id": "29375080d5f3421fb11090fe1ca95c0c"
  }
}

And again we have 201 Created response code, Location header and body with extra id, lotID, and dateModified properties.

Switch second lot to ‘composing’ status’:

PATCH /api/2.5/lots/29375080d5f3421fb11090fe1ca95c0c?acc_token=451959c45b204676a31d5dd8fe55263e HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "composing"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "composing", 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "2a1a633741414cdab85c365ca07f8467"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.995548+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.924753+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.924773+02:00", 
        "id": "ea6dbf0b0ad949f3b11d1d176d28bfd2"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "560c1259b99746cabf29bcd49e4aef4b", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "911bcc72c129493f949d7180a2c4403d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "5613b60b61bf4e4a91d1eb286df65a62", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.995381+02:00", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "d18bf1ea75c84991b3da9121ed7dc520", 
        "decisionOf": "lot"
      }
    ], 
    "id": "29375080d5f3421fb11090fe1ca95c0c"
  }
}

Let’s check what lot registry contains:

GET /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/2.5/lots?offset=2019-02-04T16%3A38%3A17.878755%2B02%3A00", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots?offset=2019-02-04T16%3A38%3A17.878755%2B02%3A00", 
    "offset": "2019-02-04T16:38:17.878755+02:00"
  }, 
  "data": [
    {
      "id": "962fa6efd16d4d55acd4b1f88bb7cec9", 
      "dateModified": "2019-02-04T16:38:17.878755+02:00"
    }
  ]
}

And indeed we have 2 lots now.

Modifying Lot

Let’s update lot description:

PATCH /api/2.5/lots/29375080d5f3421fb11090fe1ca95c0c?acc_token=451959c45b204676a31d5dd8fe55263e HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 53
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "description": "Lot description modified"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "composing", 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "2a1a633741414cdab85c365ca07f8467"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:17.995548+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.924753+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.924773+02:00", 
        "id": "ea6dbf0b0ad949f3b11d1d176d28bfd2"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "tenderAttempts": 1, 
        "procurementMethodType": "sellout.english", 
        "id": "560c1259b99746cabf29bcd49e4aef4b", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 2, 
        "procurementMethodType": "sellout.english", 
        "id": "911bcc72c129493f949d7180a2c4403d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }, 
      {
        "status": "scheduled", 
        "tenderAttempts": 3, 
        "procurementMethodType": "sellout.insider", 
        "id": "5613b60b61bf4e4a91d1eb286df65a62", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 834.6
        }
      }
    ], 
    "date": "2019-02-04T16:38:17.995381+02:00", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "d18bf1ea75c84991b3da9121ed7dc520", 
        "decisionOf": "lot"
      }
    ], 
    "id": "29375080d5f3421fb11090fe1ca95c0c"
  }
}

We see the added properties have merged with existing lot data. Additionally, the dateModified property was updated to reflect the last modification date stamp.

Note that lot can be modified only within the rectification period (up to rectificationPeriod.endDate).

Checking the listing again reflects the new modification date:

GET /api/2.5/lots?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/2.5/lots?offset=2019-02-04T16%3A38%3A17.995548%2B02%3A00", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/2.5/lots?offset=2019-02-04T16%3A38%3A17.995548%2B02%3A00", 
    "offset": "2019-02-04T16:38:17.995548+02:00"
  }, 
  "data": [
    {
      "id": "962fa6efd16d4d55acd4b1f88bb7cec9", 
      "dateModified": "2019-02-04T16:38:17.878755+02:00"
    }, 
    {
      "id": "29375080d5f3421fb11090fe1ca95c0c", 
      "dateModified": "2019-02-04T16:38:17.995548+02:00"
    }
  ]
}

Deleting Lot

Let’s delete lot:

A document with the documentType: canellationDetails has to be added first:

So now lot can be easily deleted:

PATCH /api/2.5/lots/962fa6efd16d4d55acd4b1f88bb7cec9?acc_token=f3e126c1e7734b1b8887cfbf17478baa HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 39
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "pending.deleted"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending.deleted", 
    "rectificationPeriod": {
      "startDate": "2019-02-04T16:38:18.269804+02:00", 
      "endDate": "2019-02-06T16:38:18.269804+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "Нежитлове приміщення", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "1f33640dca2f43b48787d5bceacb577a"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:17.514327+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "5d1a237b9525459d9262153c5ae5cb5f", 
        "decisionOf": "lot"
      }, 
      {
        "relatedItem": "2a30936173c74e0495d058a5c31044c7", 
        "decisionDate": "2019-02-04T16:38:18.066068+02:00", 
        "decisionID": "11111-4-5", 
        "id": "9d55bffaeced49a9bdb6b53315fa050a", 
        "decisionOf": "asset"
      }
    ], 
    "dateModified": "2019-02-04T16:38:18.487081+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "11f0bee4cf814e36b91ede32155fce67", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ec32cd417be24997af164a661733756d", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "fe87453d392845819b75c11d66cc414d", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:18.486885+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:17.586506+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:17.586543+02:00", 
        "id": "fa6b62b6f5e2400d963dd502d2d83623"
      }, 
      {
        "hash": "md5:00000000000000000000000000000000", 
        "author": "lot_owner", 
        "title": "укр.doc", 
        "url": "http://localhost/get/48050771eb984a409570e74376eb5b2b?KeyID=172d32c8&Signature=ej%2F8G%252B24t1Fu1zN2kxRy%2F2nR1569zAny9URT43NxthpXxlvtHba1g9HgTyZanWuwDjF60X8ZIIveYTZw5ZisBw%253D%253D", 
        "format": "application/msword", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:18.363290+02:00", 
        "documentType": "cancellationDetails", 
        "dateModified": "2019-02-04T16:38:18.363310+02:00", 
        "id": "ba0b14ec636c4082b4a85630d44169cd"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "c9dd31ba70cf485fa30231f3a19a81dc", 
        "relatedProcessID": "a9cbac9550db413284dcfbbf9f9cd028"
      }
    ], 
    "id": "962fa6efd16d4d55acd4b1f88bb7cec9"
  }
}

Integration with assets

Concierge operations

For lot to be formed, you need to specify id of the asset which is to be included in that lot. If this assets is available, it will be attached to lot and status of a lot itself will be changed to pending. The given lot becomes:

GET /api/2.5/lots/cee33af034594b0cab94046740c95c6b HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending", 
    "rectificationPeriod": {
      "startDate": "2019-02-04T16:38:19.591458+02:00", 
      "endDate": "2019-02-06T16:38:19.591458+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "Нежитлове приміщення", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "7840d66d09db455aadbcfe961ffa22a4"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:19.078303+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "97fb062d1fc04f6dae473a42caf7880b", 
        "decisionOf": "lot"
      }, 
      {
        "relatedItem": "35e8b82cc8dd4f5aa8d3036333587f6e", 
        "decisionDate": "2019-02-04T16:38:19.381718+02:00", 
        "decisionID": "11111-4-5", 
        "id": "01218fffebf7420297e6eea9a784799e", 
        "decisionOf": "asset"
      }
    ], 
    "dateModified": "2019-02-04T16:38:19.607017+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "next_check": "2019-02-06T16:38:19.591458+02:00", 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "f75a4ee302e248ce8011d5eb89cab577", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "89fe0464391a4b7191ac69cfd57ec7b7", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "f8ea1544ac9440c99728cea6f6470e85", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:19.606782+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:19.083999+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:19.084020+02:00", 
        "id": "5740aeb9d2634f1baea9348de36a587a"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "0757f335629d494a88469b86de4946f7", 
        "relatedProcessID": "f6b145270b8a4400bc89985051848187"
      }
    ], 
    "id": "cee33af034594b0cab94046740c95c6b"
  }
}

In case of this assets is unavailable, status of the current lot will turn to invalid The given lot becomes:

GET /api/2.5/lots/12377581a5bb413c88b7c23550d15efd HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "invalid", 
    "lotID": "UA-LR-DGF-2019-02-04-000001", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "ca606f3d9253488883b7c75a30ec8b05"
      }
    ], 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:18.555406+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "db32740a0d74425c94a1cc47f87c77a8", 
        "decisionOf": "lot"
      }, 
      {
        "relatedItem": "11111111111111111111111111111111", 
        "decisionDate": "2019-02-04T16:38:18.872451+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "057acb518c2d4d938e661c2dd236aa08", 
        "decisionOf": "asset"
      }
    ], 
    "lotType": "loki", 
    "dateModified": "2019-02-04T16:38:19.031067+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:18.563560+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:18.563586+02:00", 
        "id": "a2eb4ec41830465b979b00ae8d5706fa"
      }
    ], 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "c91499bf95b641b4a5050faa697abc73", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "8fecb590e88244408faa36b682cd8d27", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "6436a146b6184387b3a275b8fd3910f8", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:19.030894+02:00", 
    "relatedProcesses": [
      {
        "type": "asset", 
        "id": "b13f1399bef14e6b97ce667ee013c1fa", 
        "relatedProcessID": "e39a5bb622334707877baa57eff447cc"
      }
    ], 
    "id": "12377581a5bb413c88b7c23550d15efd"
  }
}

When bot finds that status of lot is pending.deleted, it turns status of the asset being attached to that lot to pending. Status of the lot itself will become deleted. The given lot becomes:

GET /api/2.5/lots/cee33af034594b0cab94046740c95c6b HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "deleted", 
    "rectificationPeriod": {
      "startDate": "2019-02-04T16:38:19.591458+02:00", 
      "endDate": "2019-02-06T16:38:19.591458+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000002", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "Нежитлове приміщення", 
    "contracts": [
      {
        "status": "cancelled", 
        "type": "yoke", 
        "id": "7840d66d09db455aadbcfe961ffa22a4"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:19.078303+02:00", 
        "decisionID": "initialDecisionID", 
        "id": "97fb062d1fc04f6dae473a42caf7880b", 
        "decisionOf": "lot"
      }, 
      {
        "relatedItem": "35e8b82cc8dd4f5aa8d3036333587f6e", 
        "decisionDate": "2019-02-04T16:38:19.381718+02:00", 
        "decisionID": "11111-4-5", 
        "id": "01218fffebf7420297e6eea9a784799e", 
        "decisionOf": "asset"
      }
    ], 
    "dateModified": "2019-02-04T16:38:19.937920+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "f75a4ee302e248ce8011d5eb89cab577", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "89fe0464391a4b7191ac69cfd57ec7b7", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "f8ea1544ac9440c99728cea6f6470e85", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:19.937742+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:19.083999+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:19.084020+02:00", 
        "id": "5740aeb9d2634f1baea9348de36a587a"
      }, 
      {
        "hash": "md5:00000000000000000000000000000000", 
        "author": "lot_owner", 
        "title": "укр.doc", 
        "url": "http://localhost/get/d1b60a17aa6947f7af224e9e167f67c7?KeyID=172d32c8&Signature=cdekvRRIIgbd%252Bi8YBsiox4L1Wxx0N1ivhcnmJq7rpXJzYeeSXw9uL8yJ07nDblHrqNWbmFXIEE2oa%252BFJFvvBDw%253D%253D", 
        "format": "application/msword", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:19.684473+02:00", 
        "documentType": "cancellationDetails", 
        "dateModified": "2019-02-04T16:38:19.684492+02:00", 
        "id": "0e09490b8c5b4fb4a92cb8fee71bbf10"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "0757f335629d494a88469b86de4946f7", 
        "relatedProcessID": "f6b145270b8a4400bc89985051848187"
      }
    ], 
    "id": "cee33af034594b0cab94046740c95c6b"
  }
}

When bot finds that status of lot is pending.dissolution, it turns status of the asset being attached to that lot to pending. Status of the lot itself will become dissolved. The given lot becomes:

GET /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "dissolved", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "cancelled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:21.260683+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:21.260479+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

When bot finds that status of lot is pending.sold, it turns status of the asset being attached to that lot to complete. Status of the lot itself turns to sold. The given lot becomes:

GET /api/2.5/lots/7a664c41089f40e3836284db2f4ac963 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "sold", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:21.833935+02:00", 
      "endDate": "2019-02-02T16:38:21.833935+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000004", 
    "title": "title", 
    "contracts": [
      {
        "status": "complete", 
        "type": "yoke", 
        "id": "d8bd7e5bc39c4653a37d762ccfd0d963"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:21.849671+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "14a8295ad72747a1b4d8b1ca2de90d7b", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:21.849690+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "843f1c97f5964f51bb481192f206e163", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:22.331036+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:21.324619+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:21.324638+02:00", 
        "id": "64d66805b9ee487f909e389871b0c08a"
      }
    ], 
    "auctions": [
      {
        "status": "complete", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "efda1f6b06fd4d36a19b4ae5522bda40", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "8086d12b6e3f4fbbaa49265006d77aac", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ed5031bd4abc4e2ab989d6fe2fe2b13a", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:22.330860+02:00", 
    "relatedProcesses": [
      {
        "type": "asset", 
        "id": "94d56e09a8e847f4bbedbea1c6c0b159", 
        "relatedProcessID": "e6dffe2398e64b54ae6fa6b1a581dfaa"
      }
    ], 
    "id": "7a664c41089f40e3836284db2f4ac963"
  }
}

Convoy operations

The procedure will be formed automatically after rectificationPeriod.endDate. For this to be done, lot status automatically receives active.salable at first:

GET /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y2hyb25vZ3JhcGg6
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "active.salable", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:20.709025+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:20.708835+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

When the procedure is successfully created, lot status changes to active.auction:

PATCH /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Content-Length: 38
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "active.auction"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "active.auction", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:20.850553+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:20.850379+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

If the procedure (procurementMethodType: sellout.english) becomes unsuccessful, lot status turns to active.salable:

GET /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y2hyb25vZ3JhcGg6
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "active.salable", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:20.709025+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:20.708835+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

As long as a new procedure is being automatically created, the lot will be given active.auction status:

PATCH /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Content-Length: 38
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "active.auction"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "active.auction", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:20.850553+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "scheduled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:20.850379+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

In case of that lot has not been sold (either contract has become unsuccessful or a procedure has received cancelled status or third procedure (procurementMethodType: sellout.insider) has turned to unsuccessful) , its status becomes pending.dissolution. This happens if all three auctions are in unsuccessful status or one has been given cancelled. The given lot becomes:

GET /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y29udm95Og==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending.dissolution", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "cancelled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:21.061436+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:21.061156+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

When contract has been successfully created within the Module of Contracting, lot’s status turns to active.contracting, after what lot becomes complete:

GET /api/2.5/lots/c800a330a0164b5f82db00d3a66a8cfe HTTP/1.0
Authorization: Basic Y29udm95Og==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "active.contracting", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:20.573173+02:00", 
      "endDate": "2019-02-02T16:38:20.573173+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000003", 
    "description": "Нежитлове приміщення для збереження насіння", 
    "title": "title", 
    "contracts": [
      {
        "status": "scheduled", 
        "type": "yoke", 
        "id": "175f7c3372aa4963a2ff79912cf96f9f"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "lotHolder": {
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Власник лоту"
    }, 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:20.595686+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "e3f3218a13cc40ea92588e4868d47b7a", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:20.595708+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "8781ad18af62490da55de14d536d6971", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:20.921881+02:00", 
    "owner": "broker", 
    "lotCustodian": {
      "contactPoint": {
        "name": "Сергій", 
        "email": "segiy@mail.com"
      }, 
      "identifier": {
        "scheme": "AE-ADCD", 
        "id": "11111-4"
      }, 
      "name": "Зберігач лоту", 
      "address": {
        "countryName": "Україна"
      }
    }, 
    "auctions": [
      {
        "status": "complete", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "92f4666e1054495eb4b34aaf9e0565e2", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ef1c10575c634ed09e5abc9f13499fed", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "2f5fa2ed4d9e4d7c9698e647b2dfc6db", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:20.921328+02:00", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:20.008310+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:20.008329+02:00", 
        "id": "5079eee05e114d06a0ba341f4a76dfe7"
      }
    ], 
    "relatedProcesses": [
      {
        "identifier": "UA-AR-P-2018-08-17-000002-1", 
        "type": "asset", 
        "id": "84b593d8ff7a461ca8a80441b5c9f1f0", 
        "relatedProcessID": "c57eb8919087424e863a4a03bebc60ff"
      }
    ], 
    "id": "c800a330a0164b5f82db00d3a66a8cfe"
  }
}

When contract reaches terminated status, lot automatically becomes pending.sold, after what lot becomes complete:

GET /api/2.5/lots/7a664c41089f40e3836284db2f4ac963 HTTP/1.0
Authorization: Basic Y2FyYXZhbjo=
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending.sold", 
    "rectificationPeriod": {
      "startDate": "2019-02-01T16:38:21.833935+02:00", 
      "endDate": "2019-02-02T16:38:21.833935+02:00"
    }, 
    "lotID": "UA-LR-DGF-2019-02-04-000004", 
    "title": "title", 
    "contracts": [
      {
        "status": "complete", 
        "type": "yoke", 
        "id": "d8bd7e5bc39c4653a37d762ccfd0d963"
      }
    ], 
    "items": [
      {
        "registrationDetails": {
          "status": "unknown"
        }, 
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CPV", 
          "description": "Description", 
          "id": "73110000-6"
        }, 
        "additionalClassifications": [
          {
            "scheme": "UA-EDR", 
            "description": "папір і картон гофровані, паперова й картонна тара", 
            "id": "111111-4"
          }
        ], 
        "address": {
          "countryName": "Ukraine"
        }, 
        "id": "0", 
        "unit": {
          "code": "code"
        }, 
        "quantity": 5.0001
      }
    ], 
    "lotType": "loki", 
    "decisions": [
      {
        "decisionDate": "2019-02-04T16:38:21.849671+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "14a8295ad72747a1b4d8b1ca2de90d7b", 
        "decisionOf": "lot"
      }, 
      {
        "decisionDate": "2019-02-04T16:38:21.849690+02:00", 
        "decisionID": "decisionAssetID", 
        "id": "843f1c97f5964f51bb481192f206e163", 
        "decisionOf": "lot"
      }
    ], 
    "dateModified": "2019-02-04T16:38:22.201807+02:00", 
    "owner": "broker", 
    "documents": [
      {
        "description": "Перелік та реквізити авторизованих електронних майданчиків (найменування установи банку, її адреса та номери рахунків, відкритих для внесення гарантійного внеску, реєстраційного внеску)", 
        "title": "Перелік та реквізити авторизованих електронних майданчиків", 
        "url": "https://prozorro.sale/info/elektronni-majdanchiki-ets-prozorroprodazhi-cbd2", 
        "documentOf": "lot", 
        "datePublished": "2019-02-04T16:38:21.324619+02:00", 
        "documentType": "x_PlatformLegalDetails", 
        "dateModified": "2019-02-04T16:38:21.324638+02:00", 
        "id": "64d66805b9ee487f909e389871b0c08a"
      }
    ], 
    "auctions": [
      {
        "status": "complete", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 300.87, 
          "valueAddedTaxIncluded": true
        }, 
        "auctionPeriod": {
          "startDate": "2019-02-08T16:43:16.610865+02:00"
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 3000.87, 
          "valueAddedTaxIncluded": true
        }, 
        "id": "efda1f6b06fd4d36a19b4ae5522bda40", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 1, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 700.87
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 150.44, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.english", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "8086d12b6e3f4fbbaa49265006d77aac", 
        "auctionParameters": {
          "type": "english"
        }, 
        "tenderAttempts": 2, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }, 
      {
        "status": "cancelled", 
        "bankAccount": {
          "accountIdentification": [
            {
              "scheme": "accountNumber", 
              "id": "111111-8", 
              "description": "some description"
            }
          ], 
          "bankName": "name of bank"
        }, 
        "minimalStep": {
          "currency": "UAH", 
          "amount": 0, 
          "valueAddedTaxIncluded": true
        }, 
        "registrationFee": {
          "currency": "UAH", 
          "amount": 700.87
        }, 
        "procurementMethodType": "sellout.insider", 
        "value": {
          "currency": "UAH", 
          "amount": 1500.44, 
          "valueAddedTaxIncluded": true
        }, 
        "tenderingDuration": "P25DT12H", 
        "id": "ed5031bd4abc4e2ab989d6fe2fe2b13a", 
        "auctionParameters": {
          "type": "insider", 
          "dutchSteps": 99
        }, 
        "tenderAttempts": 3, 
        "guarantee": {
          "currency": "UAH", 
          "amount": 350.44
        }
      }
    ], 
    "date": "2019-02-04T16:38:22.201551+02:00", 
    "relatedProcesses": [
      {
        "type": "asset", 
        "id": "94d56e09a8e847f4bbedbea1c6c0b159", 
        "relatedProcessID": "e6dffe2398e64b54ae6fa6b1a581dfaa"
      }
    ], 
    "id": "7a664c41089f40e3836284db2f4ac963"
  }
}

Retrieving Lot Information

Getting list of all lots

Getting list of all lots.

Example request:

Example response:

query offset:offset number
query limit:limit number. default is 100
reqheader Authorization:
 optional OAuth token to authenticate
statuscode 200:no error
statuscode 404:endpoint not found

Sorting

Lots returned are sorted by modification time.

Limiting number of Lots returned

You can control the number of data entries in the lots feed (batch size) with limit parameter. If not specified, data is being returned in batches of 100 elements.

Batching

The response contains next_page element with the following properties:

offset:This is the parameter you have to add to the original request you made to get next page.
path:This is path section of URL with original parameters and offset parameter added/replaced above.
uri:The full version of URL for next page.

If next page request returns no data (i.e. empty array) then there is little sense in fetching further pages.

Synchronizing

It is often necessary to be able to syncronize central database changes with other database (we’ll call it “local”). The default sorting “by modification date” together with Batching mechanism allows one to implement synchronization effectively. The synchronization process can go page by page until there is no new data returned. Then the synchronizer has to pause for a while to let central database register some changes and attempt fetching subsequent page. The next_page guarantees that all changes from the last request are included in the new batch.

The safe frequency of synchronization requests is once per 5 minutes.

Reading the individual lot information

Getting lot details.

Example request:

Example response:

reqheader Authorization:
 optional OAuth token to authenticate
statuscode 200:no error
statuscode 404:lot not found

Authentication

Some of the API requests (especially the ones that are read-only GET requests) do not require any authenication. The other ones, that modify data into the database, require broker authentication via API key. Additionally, owner tokens are issued to facilitate multiple actor roles upon object creation.

API keys

API key is username to use with Basic Authenication scheme.

Owner tokens

Getting token

The token is issued when object is created in the database:

You can see the access with token in response. Its value can be used to modify objects further under “Owner role”.

Using token

You can pass access token in the following ways:

  1. acc_token URL query string parameter
  2. X-Access-Token HTTP request header
  3. access.token in the body of POST/PUT/PATCH request

See the example of the action with token passed as URL query string:

API in cluster mode

There is a cluster of several servers that synchronize data between each other. Client should always work with the same server to ensure consistency between separate requests to the RDB. That is why cookie is required while sending POST/PUT/PATCH/DELETE requests. Cookies provide server stickiness. You can get such cookie via GET request and then use it for POST/PUT/PATCH/DELETE.

If during operations the server requested by cookie went down or is unavailable, client will receive status code 412 of request and new cookie to use. Request should be repeated with new cookie.

Options

In addition to providing fields and their values in a request, you may also specify options to control how your request is interpreted and how the response is generated. For GET requests, options are specified as URL parameters prefixed with opt_. For POST or PUT requests, options are specified in the body, inside the top-level options object (a sibling of the data object). The option specified in the body overrides the opt_ one from URL parameter.

These options can be used in different combinations in a single request, though some of them may conflict in their impact on the response.

pretty:

?opt_pretty

options: { pretty: true }

Provides the response in “pretty” output. In case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable to use this only during debugging.

jsonp:

?opt_jsonp=myCallback

Returns the output in JSON-P format instead of plain JSON. This allows requests to come from within browsers and work around the “same origin policy.” The function named as the value of the opt_jsonp parameter will be called with a single argument, a JavaScript object representing the response.

fields:

?opt_fields=comma,separated,field,list

List of extra fields to include in response.

Performance recommendations

Rate Control

“Aggressive” IP addresses can be restricted in the speed with which servers are processing RDB requests. In this case RDB will respond with status code 429 to the requests that returned faster than allowed.

Expected client response to such restriction is to repeat requests returned with 429 status code increasing the delay between individual requests sent to the RDB until requests become successful (2xx / 3xx responses).

Such RDB servers behavior is required in order to distribute server resources evenly between clients.

Date Format: ISO 8601

The date format is ISO 8601.

http://imgs.xkcd.com/comics/iso_8601.png

Responses

After processing API always provides response, reporting either success or failure.

Status Codes

In all cases, the API should return an HTTP Status Code that indicates the nature of the failure (see below), with a response body in JSON format containing additional information.

200
Success. If data was requested, it will be available in the data field at the top level of the response body.
201
Success (for object creation). Its information is available in the data field at the top level of the response body. The API URL where the object can be retrieved is also returned in the Location header of the response.
400
Invalid request. This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again.
401
No authorization. A valid API key was not provided with the request, so the API could not associate a user with the request.
403
Forbidden. The API key and request syntax was valid but the server is refusing to complete the request. This can happen if you are trying to read or write to objects or properties that you do not have access to.
404
Not found. Either the request method and path supplied do not specify a known action in the API, or the object specified by the request does not exist.
412
Precondition Failed. See API in cluster mode.
429
Rate Limit Enforced. See Rate control.
500
Server error. There was a problem on OpenProcurement’s end.

Success Response

Every successful get, create, update, replace request results in response that contains data attribute. That data attribute contains full JSON object representation after the operation. If some data were generated in the result of processing (like new object IDs, or modified date) they are present in the respose.

The listing requests result in similar responses, but instead of single object in data attribute, the JSON response contains collection of objects.

Example Success Response

Here is a response that describes lot

Error Response

In the event of an error, the response body will contain an errors field at the top level. It contains an array of at least one error object, described below:

location:

Part of the request causing the error. Possible values are header and body.

name:
  • Specific header name that caused the problem (in case of header location)
  • The field name causing the error (in case of body location)
description:

Verbose (human readable) description of the error.

Example Error Response

Sample below indicates incomplete request.

Acceleration mode for sandbox

If you want to experiment with lot, you can use acceleration mode and start your lot name with “TESTING”.

Acceleration mode was developed to enable procedure testing in the sandbox and to reduce periods of this procedure.

To enable acceleration mode you will need to:
  • add additional parameter mode with a value test;
  • set quick, accelerator=1440 as text value for procurementMethodDetails. This parameter will accelerate auction periods. The number 1440 shows that restrictions and time frames will be reduced in 1440 times.
  • set quick, accelerator=1440 as text value for sandboxParameters. This parameter will accelerate lot fnd asset periods. The number 1440 shows that restrictions and time frames will be reduced in 1440 times.
  • set quick as a value for submissionMethodDetails. This parameter works only with mode = "test" and will speed up auction start date.

This mode will work only in the sandbox.


Synchronization

  • During normal auction synchronization via /auctions test auctions are not visible.
  • To get test auctions synchronize via /auctions?mode=test.
  • If you synchronize via /auctions?mode=all, then you will get all auctions.
  • Auction mode can be set only on lot creation (lots.auctions) phase, it can not be set later.

Note

Can not be used for assets.

Indices and tables