EDC

Contract-Agreements

This section provides an overview of all available APIs that adhere to the OpenAPI specification. All APIs are loaded from the OpenAPI specification file: Link. Please note that the API base-paths may differ depending on the connector, the specific API base-path can be seen in the UI dashboard.

post

Collect filtered data for the Contract Agreement Page

Body

Filters for querying a Contract Contract Agreement Page

terminationStatusstring · enumOptional

Optionally filter the resulting contract agreements by their termination status.

Possible values:
Responses
default
default response
application/json
post
POST /api/management/wrapper/ui/pages/contract-agreement-page HTTP/1.1
Host: my-connector
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "terminationStatus": "ONGOING"
}
default

default response

{
  "contractAgreements": [
    {
      "contractAgreementId": "text",
      "contractNegotiationId": "text",
      "direction": "CONSUMING",
      "counterPartyAddress": "text",
      "counterPartyId": "text",
      "contractSigningDate": "2025-07-03T09:51:32.213Z",
      "asset": {
        "dataSourceAvailability": "LIVE",
        "assetId": "text",
        "connectorEndpoint": "text",
        "participantId": "text",
        "title": "text",
        "creatorOrganizationName": "text",
        "onRequestContactEmail": "[email protected]",
        "onRequestContactEmailSubject": "Department XYZ Data Offer Request - My Product, My API",
        "language": "text",
        "description": "text",
        "descriptionShortText": "text",
        "isOwnConnector": true,
        "publisherHomepage": "text",
        "licenseUrl": "text",
        "version": "text",
        "keywords": [
          "text"
        ],
        "mediaType": "text",
        "landingPageUrl": "text",
        "httpDatasourceHintsProxyMethod": true,
        "httpDatasourceHintsProxyPath": true,
        "httpDatasourceHintsProxyQueryParams": true,
        "httpDatasourceHintsProxyBody": true,
        "dataModel": "text",
        "sovereignLegalName": "text",
        "dataSampleUrls": [
          "text"
        ],
        "referenceFileUrls": [
          "text"
        ],
        "referenceFilesDescription": "text",
        "conditionsForUse": "text",
        "dataUpdateFrequency": "text",
        "temporalCoverageFrom": "2025-07-03",
        "temporalCoverageToInclusive": "2025-07-03",
        "assetJsonLd": "text",
        "customJsonAsString": "text",
        "customJsonLdAsString": "text",
        "privateCustomJsonAsString": "text",
        "privateCustomJsonLdAsString": "text"
      },
      "contractPolicy": {
        "policyJsonLd": "text",
        "expression": {
          "type": "EMPTY",
          "expressions": [
            "[Circular Reference]"
          ],
          "constraint": {
            "left": "text",
            "operator": "EQ",
            "right": {
              "type": "STRING",
              "value": "text",
              "valueList": [
                "text"
              ]
            }
          }
        },
        "errors": [
          "text"
        ]
      },
      "transferProcesses": [
        {
          "transferProcessId": "text",
          "lastUpdatedDate": "2025-07-03T09:51:32.213Z",
          "state": {
            "name": "text",
            "code": 1,
            "simplifiedState": "RUNNING"
          },
          "errorMessage": "text"
        }
      ],
      "terminationStatus": "ONGOING",
      "terminationInformation": {
        "terminatedAt": "2025-07-03T09:51:32.213Z",
        "reason": "text",
        "detail": "text",
        "terminatedBy": "SELF"
      }
    }
  ]
}
get

Get a single contract agreement card by its identifier

Path parameters
contractAgreementIdstringRequired
Responses
default
default response
application/json
get
GET /api/management/wrapper/ui/pages/contract-agreement-page/{contractAgreementId} HTTP/1.1
Host: my-connector
Accept: */*
default

default response

{
  "contractAgreementId": "text",
  "contractNegotiationId": "text",
  "direction": "CONSUMING",
  "counterPartyAddress": "text",
  "counterPartyId": "text",
  "contractSigningDate": "2025-07-03T09:51:32.213Z",
  "asset": {
    "dataSourceAvailability": "LIVE",
    "assetId": "text",
    "connectorEndpoint": "text",
    "participantId": "text",
    "title": "text",
    "creatorOrganizationName": "text",
    "onRequestContactEmail": "[email protected]",
    "onRequestContactEmailSubject": "Department XYZ Data Offer Request - My Product, My API",
    "language": "text",
    "description": "text",
    "descriptionShortText": "text",
    "isOwnConnector": true,
    "publisherHomepage": "text",
    "licenseUrl": "text",
    "version": "text",
    "keywords": [
      "text"
    ],
    "mediaType": "text",
    "landingPageUrl": "text",
    "httpDatasourceHintsProxyMethod": true,
    "httpDatasourceHintsProxyPath": true,
    "httpDatasourceHintsProxyQueryParams": true,
    "httpDatasourceHintsProxyBody": true,
    "dataModel": "text",
    "sovereignLegalName": "text",
    "dataSampleUrls": [
      "text"
    ],
    "referenceFileUrls": [
      "text"
    ],
    "referenceFilesDescription": "text",
    "conditionsForUse": "text",
    "dataUpdateFrequency": "text",
    "temporalCoverageFrom": "2025-07-03",
    "temporalCoverageToInclusive": "2025-07-03",
    "assetJsonLd": "text",
    "customJsonAsString": "text",
    "customJsonLdAsString": "text",
    "privateCustomJsonAsString": "text",
    "privateCustomJsonLdAsString": "text"
  },
  "contractPolicy": {
    "policyJsonLd": "text",
    "expression": {
      "type": "EMPTY",
      "expressions": [
        {
          "type": "EMPTY",
          "expressions": [
            "[Circular Reference]"
          ],
          "constraint": {
            "left": "text",
            "operator": "EQ",
            "right": {
              "type": "STRING",
              "value": "text",
              "valueList": [
                "text"
              ]
            }
          }
        }
      ],
      "constraint": {
        "left": "text",
        "operator": "EQ",
        "right": {
          "type": "STRING",
          "value": "text",
          "valueList": [
            "text"
          ]
        }
      }
    },
    "errors": [
      "text"
    ]
  },
  "transferProcesses": [
    {
      "transferProcessId": "text",
      "lastUpdatedDate": "2025-07-03T09:51:32.213Z",
      "state": {
        "name": "text",
        "code": 1,
        "simplifiedState": "RUNNING"
      },
      "errorMessage": "text"
    }
  ],
  "terminationStatus": "ONGOING",
  "terminationInformation": {
    "terminatedAt": "2025-07-03T09:51:32.213Z",
    "reason": "text",
    "detail": "text",
    "terminatedBy": "SELF"
  }
}
post

Initiate a Transfer Process via a custom Transfer Process JSON-LD. Fields such as connectorId, assetId, providerConnectorId, providerConnectorAddress will be set automatically.

Body

Required data for starting a Contract Agreement's Transfer Process

contractAgreementIdstringRequired

Contract Agreement ID

transferProcessRequestJsonLdstringRequired

Partial TransferProcessRequestJsonLd JSON-LD. Fields participantId, connectorEndpoint, assetId and contractId can be omitted, they will be overridden with information from the contract.

Responses
default
default response
application/json
post
POST /api/management/wrapper/ui/pages/contract-agreement-page/transfers/custom HTTP/1.1
Host: my-connector
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "contractAgreementId": "text",
  "transferProcessRequestJsonLd": "text"
}
default

default response

{
  "id": "text",
  "lastUpdatedDate": "2025-07-03T09:51:32.213Z"
}
post

Terminates a contract agreement designated by its contract agreement id.

Path parameters
contractAgreementIdstringRequired
Body

Data for terminating a Contract Agreement

detailstring · max: 1000Required

A user explanation to detail why the contract was terminated.

reasonstring · max: 100Required

A short reason why this contract was terminated

Responses
default
default response
application/json
post
POST /api/management/wrapper/ui/pages/content-agreement-page/{contractAgreementId}/terminate HTTP/1.1
Host: my-connector
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "detail": "text",
  "reason": "text"
}
default

default response

{
  "id": "text",
  "lastUpdatedDate": "2025-07-03T09:51:32.213Z"
}

Last updated

Was this helpful?