Webhook/Subscription Management API

Manage the notifications of events that occur during the lifecycle of a contract.

There are many different events that occur during the lifecycle of a contract. ARC has been designed to be integrated into external applications, generally trading desks and other financial services applications. The subscription management API allows you to request to be notified via an API call when any of these various events occur.

Note: if you would like to subscribe to different endpoints for different event types, you can create multiple subscriptions.

Create a Subscription

You can request to subscribe to any of the above events. After subscribing, any time you are a counterparty to a contract, and you meet the criteria, the web endpoint you specify in the subscription will receive a POST request with the associated data.

Request format

method: 'POST'
endpoint: '/api/external/arc/webhook'
headers: { 'Content-Type': 'application/json', 'X-API-KEY': 'your api key' }
body: {
    "url": "https://your.webhook.domain/endpoint",
    "eventTypes": [
        "any of the Event Types listed above"
    ]
}

Response format

{}

Get All Subscriptions

You can see all of the events your currently subscribed to.

Request format

method: 'GET'
endpoint: '/api/external/arc/webhook'
headers: { 'Content-Type': 'application/json', 'X-API-KEY': 'your api key' }

Response format

{
    "webhookSubscriptions": [
        {
            "_id": "669d244eec184e90e49c2854",
            "webhookEndpoint": {
                "tenantId": "Your Account ID",
                "url": "https://your.webhook.domain/endpoint"
            },
            "eventType": [
                "all of the event types you are subscribed to"
            ]
        }
    ]
}

Cancel a Subscription

At any time, you can cancel subscriptions.

Request format

method: 'DELETE'
endpoint: '/api/external/arc/webhook'
headers: { 'Content-Type': 'application/json', 'X-API-KEY': 'your api key' }
body: {
    "url": "https://your.webhook.domain/endpoint",
    "eventTypes": [
        "Event types to unsubscribe from"
    ]
}

Response format

{
    "webhookSubscription": {
        "_id": "669d244eec184e90e49c2854",
        "webhookEndpoint": {
            "tenantId": "Your Account ID",
            "url": "https://your.webhook.domain/endpoint"
        },
        "eventType": [
            "Remaining events still subscribed to"
        ]
    }
}

Last updated