SIsiafoundation
contracts

Query v2 contracts

Changed on

Queries v2 contracts matching the provided filter and returns a paginated result.

post/v2/contracts

Request

  • Base URL
    http://localhost:9980/api
  • URL
    http://localhost:9980/api/v2/contracts
  • Auth
    HTTP basic

Request body

statusesstring[]

Filter by v2 contract statuses.

contractIDsFileContractID[]

Filter by specific contract IDs.

renewedFromFileContractID[]

Filter by the contract ID this contract was renewed from.

renewedToFileContractID[]

Filter by the contract ID this contract was renewed to.

renterKeyPublicKey[]

Filter by renter public keys.

minNegotiationHeightinteger

Minimum block height at which the contract was negotiated.

maxNegotiationHeightinteger

Maximum block height at which the contract was negotiated.

minExpirationHeightinteger

Minimum contract expiration block height.

maxExpirationHeightinteger

Maximum contract expiration block height.

limitinteger

Maximum number of v2 contracts to return per page. Defaults to 100.

offsetinteger

Number of contracts to skip for pagination.

sortFieldstring

Field to sort results by. Valid values are "status", "negotiationHeight", "expirationHeight".

sortDescboolean

Sort in descending order when true.

Response

V2 contracts matching filter.

countinteger required

Total number of v2 contracts matching the filter.

contractsV2Contract[] required

V2 contracts matching the filter for the current page.

Changes