bLink API - order placement module (2.2.1.1-fi)

Download OpenAPI specification:Download

URL: https://www.six-group.com/en/products-services/banking-services/blink.html

This is the specification of the bLink 'order-placement' module API. (as implemented by providers (e.g. financial institutions) and used by SIX) This API is used to place orders and check on the order status.

orderplacement

Order placement operations.

Posts a new order

Posts a new order.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Request Body schema: application/json

clientOrderIdentification required	string <= 20 characters Unambiguous identifier for the bulk order, as assigned by the instructing party.
required	object (bulkOrderDetails)
required	Array of objects (requestedAllocation)

Responses

Request samples

Payload

Content type

application/json

{"clientOrderIdentification": "123-123123",
"bulkOrderDetails": {"side": "buy",
"orderQuantity": {"amount": "12000",
"type": "unitsNumber"
},
"displayQuantity": "12000",
"numberOfAllocations": 5,
"financialInstrumentDetails": {"financialInstrumentIdentification": {"identification": "CH0012005267",
"type": "isin"
}
},
"placeOfTrade": {"marketIdentificationCode": "XSWX",
"marketDescription": "OTC"
},
"currency": "CHF",
"executionType": "limit",
"limitPrice": "17.8",
"stopPrice": "17.8",
"timeInForce": "day",
"expiryDateTime": "2018-04-13T16:00:00+01:00",
"additionalDetails": "at pre Market and today"
},
"requestedAllocationList": [{"accounts": [{"identification": "8765-43219",
"type": "safekeepingAccount"
}
],
"clientAllocationIdentification": "321321321",
"amount": "12000"
}
]
}

Response samples

Content type

application/json

{"statementDateTime": "2018-04-13T11:11:11Z",
"extendedOrder": {"clientOrderIdentification": "123-123123",
"orderDateTime": "2018-04-13T11:11:11Z",
"orderIdentification": "321-321321",
"bulkOrderDetails": {"side": "buy",
"orderQuantity": {"amount": "12000",
"type": "unitsNumber"
},
"displayQuantity": "12000",
"numberOfAllocations": 5,
"financialInstrumentDetails": {"financialInstrumentIdentification": {"identification": "CH0012005267",
"type": "isin"
}
},
"placeOfTrade": {"marketIdentificationCode": "XSWX",
"marketDescription": "OTC"
},
"currency": "CHF",
"executionType": "limit",
"limitPrice": "17.8",
"stopPrice": "17.8",
"timeInForce": "day",
"expiryDateTime": "2018-04-13T16:00:00+01:00",
"additionalDetails": "at pre Market and today"
},
"allocationList": [{"requestedAllocation": {"accounts": [{"identification": "8765-43219",
"type": "safekeepingAccount"
}
],
"clientAllocationIdentification": "321321321",
"amount": "12000"
},
"allocationCancellationReasonList": [{"code": "zeroQuantity",
"proprietary": "Cancelled by client."
}
],
"remainingAllocation": {"executedQuantity": "100",
"remainingQuantity": "20"
},
"completeAllocationList": [{"allocationIdentification": "123-123123",
"executedQuantity": "100",
"averagePrice": "17.8",
"bookingDate": {"date": "2018-04-13"
},
"billingDetails": {"billingAmountList": [{"type": "grossTradeAmount",
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
}
],
"accruedInterests": {"numberDaysAccrued": 28,
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": "CHF",
"rate": "1.0963",
"targetCurrency": "CHF",
"fxType": "costPrice"
}
},
"feesOrTaxList": [{"feeType": "stampDuty",
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
}
]
}
}
]
}
]
},
"orderState": {"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z",
"orderCancellationReasonList": [{"code": "endOfLife",
"proprietary": "Cancelled by client"
}
],
"executedQuantity": "100",
"remainingQuantity": "20",
"averagePrice": "17.8",
"dayOrderQuantity": "15",
"dayExecutedQuantity": "5",
"dayAveragePrice": "17.8",
"factor": "100",
"orderStatusHistoryList": [{"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z"
}
]
},
"dateList": [{"date": "2018-04-13",
"dateType": "bookingDate"
}
]
}

Cancellation of a specific order

Places the cancellation request for a specific order.

path Parameters

clientOrderId

required

string <= 20 characters

The security order id. This Id corresponds with the clientOrderIdentification.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/json

{"statementDateTime": "2018-04-13T11:11:11Z",
"extendedOrder": {"clientOrderIdentification": "123-123123",
"orderDateTime": "2018-04-13T11:11:11Z",
"orderIdentification": "321-321321",
"bulkOrderDetails": {"side": "buy",
"orderQuantity": {"amount": "12000",
"type": "unitsNumber"
},
"displayQuantity": "12000",
"numberOfAllocations": 5,
"financialInstrumentDetails": {"financialInstrumentIdentification": {"identification": "CH0012005267",
"type": "isin"
}
},
"placeOfTrade": {"marketIdentificationCode": "XSWX",
"marketDescription": "OTC"
},
"currency": "CHF",
"executionType": "limit",
"limitPrice": "17.8",
"stopPrice": "17.8",
"timeInForce": "day",
"expiryDateTime": "2018-04-13T16:00:00+01:00",
"additionalDetails": "at pre Market and today"
},
"allocationList": [{"requestedAllocation": {"accounts": [{"identification": "8765-43219",
"type": "safekeepingAccount"
}
],
"clientAllocationIdentification": "321321321",
"amount": "12000"
},
"allocationCancellationReasonList": [{"code": "zeroQuantity",
"proprietary": "Cancelled by client."
}
],
"remainingAllocation": {"executedQuantity": "100",
"remainingQuantity": "20"
},
"completeAllocationList": [{"allocationIdentification": "123-123123",
"executedQuantity": "100",
"averagePrice": "17.8",
"bookingDate": {"date": "2018-04-13"
},
"billingDetails": {"billingAmountList": [{"type": "grossTradeAmount",
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
}
],
"accruedInterests": {"numberDaysAccrued": 28,
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": "CHF",
"rate": "1.0963",
"targetCurrency": "CHF",
"fxType": "costPrice"
}
},
"feesOrTaxList": [{"feeType": "stampDuty",
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
}
]
}
}
]
}
]
},
"orderState": {"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z",
"orderCancellationReasonList": [{"code": "endOfLife",
"proprietary": "Cancelled by client"
}
],
"executedQuantity": "100",
"remainingQuantity": "20",
"averagePrice": "17.8",
"dayOrderQuantity": "15",
"dayExecutedQuantity": "5",
"dayAveragePrice": "17.8",
"factor": "100",
"orderStatusHistoryList": [{"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z"
}
]
},
"dateList": [{"date": "2018-04-13",
"dateType": "bookingDate"
}
]
}

orderstatus

Order status operations.

Returns a list of open security orders

Returns all open orders to which the user of the API has access to. Paging is done based on the order object, i.e. if limit is set to 1, then 1 order will be returned per page.

query Parameters

cursor	string An opaque string value used for pagination.
limit	integer <int32> >= 1 Maximum number of items to return.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/json

[{"statementDateTime": "2018-04-13T11:11:11Z",
"extendedOrder": {"clientOrderIdentification": "123-123123",
"orderDateTime": "2018-04-13T11:11:11Z",
"orderIdentification": "321-321321",
"bulkOrderDetails": {"side": "buy",
"orderQuantity": {"amount": "12000",
"type": "unitsNumber"
},
"displayQuantity": "12000",
"numberOfAllocations": 5,
"financialInstrumentDetails": {"financialInstrumentIdentification": {"identification": "CH0012005267",
"type": "isin"
}
},
"placeOfTrade": {"marketIdentificationCode": "XSWX",
"marketDescription": "OTC"
},
"currency": "CHF",
"executionType": "limit",
"limitPrice": "17.8",
"stopPrice": "17.8",
"timeInForce": "day",
"expiryDateTime": "2018-04-13T16:00:00+01:00",
"additionalDetails": "at pre Market and today"
},
"allocationList": [{"requestedAllocation": {"accounts": [{"identification": "8765-43219",
"type": "safekeepingAccount"
}
],
"clientAllocationIdentification": "321321321",
"amount": "12000"
},
"allocationCancellationReasonList": [{"code": "zeroQuantity",
"proprietary": "Cancelled by client."
}
],
"remainingAllocation": {"executedQuantity": "100",
"remainingQuantity": "20"
},
"completeAllocationList": [{"allocationIdentification": "123-123123",
"executedQuantity": "100",
"averagePrice": "17.8",
"bookingDate": {"date": "2018-04-13"
},
"billingDetails": {"billingAmountList": [{"type": null,
"amount": null,
"currency": null,
"creditDebitIndicator": null,
"foreignExchangeRate": null
}
],
"accruedInterests": {"numberDaysAccrued": 28,
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
},
"feesOrTaxList": [{"feeType": null,
"amount": null,
"currency": null,
"creditDebitIndicator": null,
"foreignExchangeRate": null
}
]
}
}
]
}
]
},
"orderState": {"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z",
"orderCancellationReasonList": [{"code": "endOfLife",
"proprietary": "Cancelled by client"
}
],
"executedQuantity": "100",
"remainingQuantity": "20",
"averagePrice": "17.8",
"dayOrderQuantity": "15",
"dayExecutedQuantity": "5",
"dayAveragePrice": "17.8",
"factor": "100",
"orderStatusHistoryList": [{"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z"
}
]
},
"dateList": [{"date": "2018-04-13",
"dateType": "bookingDate"
}
]
}
]

Returns a single security order

Returns a specific security order.

path Parameters

clientOrderId

required

string <= 20 characters

The security order id. This Id corresponds with the clientOrderIdentification.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/json

{"statementDateTime": "2018-04-13T11:11:11Z",
"extendedOrder": {"clientOrderIdentification": "123-123123",
"orderDateTime": "2018-04-13T11:11:11Z",
"orderIdentification": "321-321321",
"bulkOrderDetails": {"side": "buy",
"orderQuantity": {"amount": "12000",
"type": "unitsNumber"
},
"displayQuantity": "12000",
"numberOfAllocations": 5,
"financialInstrumentDetails": {"financialInstrumentIdentification": {"identification": "CH0012005267",
"type": "isin"
}
},
"placeOfTrade": {"marketIdentificationCode": "XSWX",
"marketDescription": "OTC"
},
"currency": "CHF",
"executionType": "limit",
"limitPrice": "17.8",
"stopPrice": "17.8",
"timeInForce": "day",
"expiryDateTime": "2018-04-13T16:00:00+01:00",
"additionalDetails": "at pre Market and today"
},
"allocationList": [{"requestedAllocation": {"accounts": [{"identification": "8765-43219",
"type": "safekeepingAccount"
}
],
"clientAllocationIdentification": "321321321",
"amount": "12000"
},
"allocationCancellationReasonList": [{"code": "zeroQuantity",
"proprietary": "Cancelled by client."
}
],
"remainingAllocation": {"executedQuantity": "100",
"remainingQuantity": "20"
},
"completeAllocationList": [{"allocationIdentification": "123-123123",
"executedQuantity": "100",
"averagePrice": "17.8",
"bookingDate": {"date": "2018-04-13"
},
"billingDetails": {"billingAmountList": [{"type": "grossTradeAmount",
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
}
],
"accruedInterests": {"numberDaysAccrued": 28,
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": "CHF",
"rate": "1.0963",
"targetCurrency": "CHF",
"fxType": "costPrice"
}
},
"feesOrTaxList": [{"feeType": "stampDuty",
"amount": "12000",
"currency": "CHF",
"creditDebitIndicator": "debit",
"foreignExchangeRate": {"sourceCurrency": null,
"rate": null,
"targetCurrency": null,
"fxType": null
}
}
]
}
}
]
}
]
},
"orderState": {"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z",
"orderCancellationReasonList": [{"code": "endOfLife",
"proprietary": "Cancelled by client"
}
],
"executedQuantity": "100",
"remainingQuantity": "20",
"averagePrice": "17.8",
"dayOrderQuantity": "15",
"dayExecutedQuantity": "5",
"dayAveragePrice": "17.8",
"factor": "100",
"orderStatusHistoryList": [{"status": "partiallyFilled",
"statusDateTime": "2018-04-13T11:11:11Z"
}
]
},
"dateList": [{"date": "2018-04-13",
"dateType": "bookingDate"
}
]
}

accountaccess

Account access operations.

Returns list of accounts the requestor has access to

Returns list of accounts the requestor has access to with the type of access the requestor has. Paging is done based on the accountaccess object, i.e. if limit is set to 1, then 1 accountaccess object will be returned per page.

query Parameters

cursor	string An opaque string value used for pagination.
limit	integer <int32> >= 1 Maximum number of items to return.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/json

[{"account": {"identification": "8765-43219",
"type": "safekeepingAccount"
},
"accessType": "read"
}
]

event-notification-subscription

Event notification subscription operations.

Subscribe to Events

Allows TPP to subscribe to specific events for the API.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Request Body schema: application/json

eventTypes

Array of strings (eventType)

Items Enum: "heartbeat" "order:doneForDay" "order:orderStatusUpdated" "order:pendingReplace" "order:replaced" "order:restated" "order:suspended" "order:trade" "order:tradeCancel" "order:tradeCorrect"

Array of event types the subscription applies to. An empty list indicates that no notifications are sent.

Responses

Request samples

Payload

Content type

application/json

{"eventTypes": ["order:orderStatusUpdated"
]
}

Response samples

Content type

application/json

{"eventSubscriptionId": "3v3n7subscr1p70n",
"eventTypes": ["order:orderStatusUpdated"
]
}

View Subscriptions

Allows TPP to view the event subscriptions.

query Parameters

cursor	string An opaque string value used for pagination.
limit	integer <int32> >= 1 Maximum number of items to return.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/json

{"eventSubscriptions": [{"eventSubscriptionId": "3v3n7subscr1p70n",
"eventTypes": ["order:orderStatusUpdated"
]
}
]
}

View Subscription

Allows TPP to view the event subscription.

path Parameters

eventSubscriptionId

required

string [ 1 .. 40 ] characters

Unique identification as assigned by the API exposing party to uniquely identify the callback URL resource.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/json

{"eventSubscriptionId": "3v3n7subscr1p70n",
"eventTypes": ["order:orderStatusUpdated"
]
}

Change event subscription

Changes event subscription.

path Parameters

eventSubscriptionId

required

string [ 1 .. 40 ] characters

Unique identification as assigned by the API exposing party to uniquely identify the callback URL resource.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Request Body schema: application/json
required

eventSubscriptionId required	string (eventSubscriptionId) [ 1 .. 40 ] characters Unique identification as assigned by the API exposing party to uniquely identify the callback URL resource.
eventTypes	Array of strings (eventType) Items Enum: "heartbeat" "order:doneForDay" "order:orderStatusUpdated" "order:pendingReplace" "order:replaced" "order:restated" "order:suspended" "order:trade" "order:tradeCancel" "order:tradeCorrect" Array of event types the subscription applies to. An empty list indicates that no notifications are sent.

Responses

Request samples

Payload

Content type

application/json

{"eventSubscriptionId": "3v3n7subscr1p70n",
"eventTypes": ["order:orderStatusUpdated"
]
}

Response samples

Content type

application/json

{"eventSubscriptionId": "3v3n7subscr1p70n",
"eventTypes": ["order:orderStatusUpdated"
]
}

Delete event subscription

Deletes event subscriptions.

path Parameters

eventSubscriptionId

required

string [ 1 .. 40 ] characters

Unique identification as assigned by the API exposing party to uniquely identify the callback URL resource.

header Parameters

Authorization required	string Bearer followed by a base64 encoded OAuth access token
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-Correlation-ID required	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
User-Agent required	string Name and version of the of the Client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

Content type

application/problem+json

{"type": "/problems/TECHNICAL_ERROR",
"title": "This is the general problem description",
"detail": "Detailed problem description with respect to the current request",
"instance": "path/to/corresponding/resource"
}

diagnostics

Diagnostics operations.

Returns all specified request headers and additional diagnostic information

header Parameters

X-Correlation-ID	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
Authorization	string Bearer followed by a base64 encoded OAuth access token
User-Agent	string Name and version of the of the client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Responses

Response samples

200

Content type

application/json

{"requestDateTime": "2018-04-13T11:11:11Z",
"receivedHeaders": [{"headerName": "X-Correlation-ID",
"headerValue": "string"
}
],
"receivedPayload": "... as received ..."
}

Returns all specified request headers, the request body and additional diagnostic information

header Parameters

X-Correlation-ID	string <= 64 characters Unique ID (defined by the caller) which will be reflected back in the response.
Authorization	string Bearer followed by a base64 encoded OAuth access token
User-Agent	string Name and version of the of the client software
X-CorAPI-Target-ID	string ID of the target, e.g., a financial institution. (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-CorAPI-Client-ID required	string ID of the client forwarded to the target. (SCOPE: FI / NOTIFICATION_RECIPIENT)
X-PSU-IP-Address	string IP address of the user initiating the operation (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)
X-PSU-User-Agent	string User of the client software (SCOPE: FI / NOTIFICATION_RECIPIENT - optional)

Request Body schema: application/json
required

string

Responses

Request samples

Payload

Content type

application/json

"string"

Response samples

200

Content type

application/json

{"requestDateTime": "2018-04-13T11:11:11Z",
"receivedHeaders": [{"headerName": "X-Correlation-ID",
"headerValue": "string"
}
],
"receivedPayload": "... as received ..."
}

bLink API - order placement module (2.2.1.1-fi)

orderplacement

Posts a new order

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Cancellation of a specific order

path Parameters

header Parameters

Responses

Response samples

orderstatus

Returns a list of open security orders

query Parameters

header Parameters

Responses

Response samples

Returns a single security order

path Parameters

header Parameters

Responses

Response samples

accountaccess

Returns list of accounts the requestor has access to

query Parameters

header Parameters

Responses

Response samples

event-notification-subscription

Subscribe to Events

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

View Subscriptions

query Parameters

header Parameters

Responses

Response samples

View Subscription

path Parameters

header Parameters

Responses

Response samples

Change event subscription

path Parameters

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Delete event subscription

path Parameters

header Parameters

Responses

Response samples

diagnostics

Returns all specified request headers and additional diagnostic information

header Parameters

Responses

Response samples

Returns all specified request headers, the request body and additional diagnostic information

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required