Contract-Negotiations

Last updated 4 months ago

Was this helpful?

get

Gets a contract negotiation with the given ID

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '//v2/contractnegotiations/{id}'

200

400

404

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
  },
  "@type": "https://w3id.org/edc/v0.0.1/ns/ContractNegotiation",
  "@id": "negotiation-id",
  "type": "PROVIDER",
  "protocol": "dataspace-protocol-http",
  "counterPartyId": "counter-party-id",
  "counterPartyAddress": "http://counter/party/address",
  "state": "VERIFIED",
  "contractAgreementId": "contract:agreement:id",
  "errorDetail": "eventual-error-detail",
  "createdAt": 1688465655,
  "callbackAddresses": [
    {
      "transactional": false,
      "uri": "http://callback/url",
      "events": [
        "contract.negotiation",
        "transfer.process"
      ],
      "authKey": "auth-key",
      "authCodeId": "auth-code-id"
    }
  ]
}

The contract negotiation

get

Gets a contract agreement for a contract negotiation with the given ID

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '//v2/contractnegotiations/{id}/agreement'

200

400

404

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
  },
  "@type": "https://w3id.org/edc/v0.0.1/ns/ContractAgreement",
  "@id": "negotiation-id",
  "providerId": "provider-id",
  "consumerId": "consumer-id",
  "assetId": "asset-id",
  "contractSigningDate": 1688465655,
  "policy": {
    "@context": "http://www.w3.org/ns/odrl.jsonld",
    "@type": "Set",
    "@id": "offer-id",
    "permission": [
      {
        "target": "asset-id",
        "action": "display"
      }
    ]
  }
}

The contract agreement that is attached to the negotiation, or null

get

Gets the state of a contract negotiation with the given ID

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '//v2/contractnegotiations/{id}/state'

200

400

404

No Content

The contract negotiation's state

post

Initiates a contract negotiation for a given offer and with the given counter part. Please note that successfully invoking this endpoint only means that the negotiation was initiated. Clients must poll the /{id}/state endpoint to track the state

Body

@contextobjectrequired

@typestringoptionalExample: https://w3id.org/edc/v0.0.1/ns/ContractRequest

callbackAddressesobject[]optionalExample: null

connectorAddressstringoptionalDeprecated

please use counterPartyAddress instead

counterPartyAddressstringrequired

offerobjectoptionalDeprecated

please use policy instead of offer

policyobjectrequired

ODRL offer

Example:

{"@context":"http://www.w3.org/ns/odrl.jsonld","@type":"odrl:Offer","@id":"offer-id","assigner":"providerId","target":"assetId","permission":[],"prohibition":[],"obligation":[]}

protocolstringrequired

providerIdstringoptionalDeprecated

please use policy.assigner instead

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/contractnegotiations' \
  --header 'Content-Type: application/json' \
  --data '{
    "@context": {
      "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
    },
    "@type": "https://w3id.org/edc/v0.0.1/ns/ContractRequest",
    "counterPartyAddress": "http://provider-address",
    "protocol": "dataspace-protocol-http",
    "policy": {
      "@context": "http://www.w3.org/ns/odrl.jsonld",
      "@type": "odrl:Offer",
      "@id": "offer-id",
      "assigner": "providerId",
      "permission": [],
      "prohibition": [],
      "obligation": [],
      "target": "assetId"
    },
    "callbackAddresses": [
      {
        "transactional": false,
        "uri": "http://callback/url",
        "events": [
          "contract.negotiation",
          "transfer.process"
        ],
        "authKey": "auth-key",
        "authCodeId": "auth-code-id"
      }
    ]
  }'

200

400

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
  },
  "@id": "id-value",
  "createdAt": 1688465655
}

The negotiation was successfully initiated. Returns the contract negotiation ID and created timestamp

post

Returns all contract negotiations according to a query

Body

@typestringoptionalExample: https://w3id.org/edc/v0.0.1/ns/QuerySpec

filterExpressionobject[]optionalExample:

{"@context":{"@vocab":"https://w3id.org/edc/v0.0.1/ns/"},"@type":"Criterion","operandLeft":"fieldName","operator":"=","operandRight":"some value"}

limitinteger · int32optional

offsetinteger · int32optional

sortFieldstringoptional

sortOrderstring · enumoptionalAvailable options:

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/contractnegotiations/request' \
  --header 'Content-Type: application/json' \
  --data '{
    "@context": {
      "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
    },
    "@type": "QuerySpec",
    "offset": 5,
    "limit": 10,
    "sortOrder": "DESC",
    "sortField": "fieldName",
    "filterExpression": []
  }'

200

400

No Content

The contract negotiations that match the query

post

Terminates the contract negotiation.

Path parameters

idstringrequired

Body

@idstringoptional

@typestringoptionalExample: https://w3id.org/edc/v0.0.1/ns/TerminateNegotiation

reasonstringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/contractnegotiations/{id}/terminate' \
  --header 'Content-Type: application/json' \
  --data '{
    "@context": {
      "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
    },
    "@type": "https://w3id.org/edc/v0.0.1/ns/TerminateNegotiation",
    "@id": "negotiation-id",
    "reason": "a reason to terminate"
  }'

200

400

404

No Content

ContractNegotiation is terminating

Show child attributes

Show child attributes

Show child attributes

Show child attributes