HomeGet a list of user accountsGet a list of user saved distributionsSubmitting a C5 order

Connect 5 - Client Services API

This page contains the details for the Client Services API. These are the public facing APIs that would allow a user to interact with our platforms.

Get a list of user accounts

This section contains the details on the API to retrieve a user's list of accounts.

gethttps://platform.businesswire.com/api/v1/client/account/lookup

No input, the user will be retrieved from the JWT that was used to call this API

Response

When the request is successful, then the statusCode will be 200, and a JSON object containing the list of account numbers and account names will be returned.

Name
Type
accountNumber
Number

The account number associated with this username.

accountName
String

Name associated with the account.

Get a list of user saved distributions

This section contains the details on the API to retrieve a user's list of saved distribution.

gethttps://platform.businesswire.com/api/v1/order/savedDistribution

No input, the user will be retrieved from the JWT that was used to call this API

Response

When the request is successful, then the statusCode will be 200, and a JSON object containing the list of saved distribution ids and names.

Name
Type
id
Number

The id associated with the saved distribution.

name
String

The name associated with the saved distribution.

Submitting a C5 order

This section contains the details on the API to submit a C5 order.

Parameters
orderRequired

Order information

workInProgressRequired

If this is true, then the order will not be submitted, instead the order will be saved under the user's drafts and can be submitted upon login. Setting this flag to false will submit the order.

scheduleRequired

This object will contain the scheduling details of the order.

Example:
{
  "accountId": 1010376,
  "scheduleType": 3,
  "dateAndTime": "2020-06-29 20:49",
  "timezoneCode": "ET"
}
accountIdRequired

The accountId of the account that the order is pertaining to. The id can be retrieved from the getAccounts api call.

scheduleTypeRequired

The code to schedule your release:

Possible enum values
1

Immediate release.

2

Hold for call.

3

Release specific time.

dateAndTime

The expected format of this string is YYYY-MM-DD HH:SS where HH:SS will be expected to be a 24hr time.

Note: if scheduleType = 3, then this parameter is REQUIRED.

timezoneCode

The code for a specific timezone.

Note: if scheduleType = 3, then this parameter is REQUIRED.

Possible enum values
NUT

Samoa

HT

Hawaii (U.S.)

AKST

Alaska Time (U.S.)

PT

Pacific Time (U.S. and Canada)

MTAZ

Arizona

MT

Mountain Time (U.S. and Canada)

CTSK

Saskatchewan

CT

Central Time (U.S. and Canada)

JAM

Jamaica

ET

Eastern Time (U.S. and Canada)

VET

Venezuela Time

BRA

Brazil (Sao Paulo)

ADT

Atlantic Time (Canada)

ADT

Newfoundland

FST

Mid-Atlantic

CVT

Cape Verde

AZOT

Azores Time

WET

British (London)

IRE

Ireland (Dublin)

PORT

Portugal

ECT

Central Europe (Berlin, Frankfurt, Paris, Rome)

EGYP

Egypt

EETI

Eastern Europe (Istanbul)

MSK

Moscow Time

IDT

Israel

AST

Arabiav

GST

Oman/UAE (Abu Dhabi, Dubai)

MVT

Islamabad, Karachi

PKST

Pakistan/West Asia

LKT

Bangladesh (Astana, Dhaka)

IST

India (Bangalore, Mumbai, New Delhi)

JT

Indochina (Bangkok, Hanoi, Jakarta)

HKT

China/Taiwan (Beijing, Hong Kong, Taipei)

WST

Australian Western (Perth)

JST

Japan (Tokyo)

KST

Korea (Seoul)

AUSN

Australian Central (North)

AUSS

Australian Central (South)

AEST

Australian Eastern (Sydney)

AEST

Australian Eastern (Queensland)

SBT

Micronesia

NZT

New Zealand (Auckland, Wellington)

distributionRequired

The distribution object will contain the id for the saved distribution a user has chosen to attach to this order.

Example:
{
  "savedDistributionId": 2
}
savedDistributionIdRequired

The id of the saved distribution attached to this order. The id can be retrieved from the getSavedDistributions api call.

filesRequired

The files that to be associated with this order. Use  files  key for each file to be upload

Note: At minimum 1 upload for releaseText is required. Additional media is optional.

Note: filename will be used to map each files upload to the files detail.

Example:
{
  "releaseText": [
    {
      "filename": "test.txt",
      "language": "en"
    }
  ],
  "logo": [
    {
      "filename": "logo.png",
      "logoUrl": "https://www.example.com"
    }
  ],
  "multimedia": [
    {
      "filename": "photo.jpg",
      "role": 3,
      "captions": [
        {
          "language": "en",
          "caption": "caption goes here"
        }
      ]
    }
  ]
}
releaseTextRequired

The object containing the order's release text.

filenameRequired

The filename that will be mapped to the filename in the uploaded multipart.

languageRequired

The language code of the release text.

Possible enum values
en

English

es

Spanish

pt

Portuguese

de

German

fr

French

it

Italian

nl

Dutch

da

Danish

no

Norwegian

sv

Swedish

fi

Finnish

pl

Polish

cs

Czech

hu

Hungarian

et

Estonian

lv

Latvian

lt

Lithuanian

ja

Japanese

zh-HK

Chinese (Traditional)

zh-CN

Chinese (Simplified)

logoRequired

The object containing the order's logo.

filenameRequired

The filename that will be mapped to the filename in the uploaded multipart.

logoUrl

The url for the logo's destination.

multimediaRequired

The object containing the order's multimedia.

filenameRequired

The filename that will be mapped to the filename in the uploaded multipart.

roleRequired

The role for the multimedia upload.

Possible enum values
2

Photo

3

Logo

6

Slideshow

7

Spreadsheet

8

Document

10

Audio

11

Video

16

Interactive Media-Image

17

Interactive Media-Video

20

Text/Table

21

Message Attachment

captionsRequired

The captions in each language for the multimedia upload.

languageRequired

The language code for the caption.

Possible enum values
en

English

es

Spanish

pt

Portuguese

de

German

fr

French

it

Italian

nl

Dutch

da

Danish

no

Norwegian

sv

Swedish

fi

Finnish

pl

Polish

cs

Czech

hu

Hungarian

et

Estonian

lv

Latvian

lt

Lithuanian

ja

Japanese

zh-HK

Chinese (Traditional)

zh-CN

Chinese (Simplified)

captionRequired

The caption string.

detailsRequired

The details object will contain all the order details.

Example:
{
  "requireCopyApproval": false,
  "specialInstructions": "example special instructions",
  "purchaseOrder": "example number",
  "pullQuotesAndTweetThis": {
    "disablePullQuote": false,
    "disableTweetBtn": false
  },
  "releaseContact": {
    "contactEmail": "test@test.com",
    "contactPhone": "123-123-1234"
  },
  "organizationInformation": {
    "securitiesIdentifier": [
      {
        "tickerSymbol": "APPL",
        "exchange": "NYSE",
        "isin": "US0004026250"
      }
    ]
  },
  "socialMedia": {
    "socialMediaByLanguage": [
      {
        "language": "en",
        "suggestedTweet": "example suggested tweet",
        "socialMediaProfiles": [
          {
            "network": "Facebook",
            "name": "Facebook Profile",
            "url": "https://www.facebook.com/test",
            "type": "organization"
          }
        ],
        "hashTags": [
          "#hash"
        ],
        "cashTags": [
          "$cash"
        ]
      }
    ]
  }
}
requireCopyApprovalRequired
specialInstructions
purchaseOrder
pullQuotesAndTweetThisRequired

This object will define how pull quotes and tweet this will be used for your order.

Example:
{
  "disablePullQuote": false,
  "disableTweetBtn": false
}
disablePullQuoteRequired

Enable or disable pull quotes on the order.

disableTweetBtnRequired

Enable or disable tweet this button on the order.

releaseContactRequired

This object will define the details for contact information.

Example:
{
  "contactEmail": "test@test.com",
  "contactPhone": "123-123-1234"
}
contactEmailRequired

The contact email for the user.

contactPhoneRequired

The contact phone for the user.

organizationInformation

This object will define securities information for the order.

Example:
{
  "securitiesIdentifier": [
    {
      "tickerSymbol": "APPL",
      "exchange": "NYSE",
      "isin": "US0004026250"
    }
  ]
}
securitiesIdentifier

The object containing securities information.

tickerSymbol

The ticker symbol for the company.

Note: if exchange is provided then this parameter is REQUIRED.

exchange

The exchange symbol for the ticker.

Note: if tickerSymbol is provided then this parameter is REQUIRED.

Possible enum values
NEO

Aequitas NEO Exchange

BXV

BX Venture Market

CNSX

Canadian Securities Exchange

NASDAQ

Nasdaq

NYSE

New York Stock Exchange

NYSEAM

NYSE American

NYX

NYSE Arca

OTCBB

OTC Bulletin Board

OTCQB

OTCQB

OTCQX

OTCQX

OTC Pink

OTC Pink

TSX

Toronto Stock Exchange

TSX VENTURE

TSX Venture Exchange

IEX

Investors Exchange

ARM

Nasdaq Armenia

ASE

Athens Stock Exchange

BLSE

Banjalucka Berza

BAR

Bolsa de Barcelona

BELEX

Beogradska berza

BCN

Börse Berlin

BIL

Bolsa de Bilbao

VSE

Bolsa de Valencia

BV

Burza Cennych Papierov v Bratislave

BX

Bursa de Valori Bucuresti

BUDAPEST

Budapest Stock Exchange

BB

Balgarska fondova borsa - Sofiya

CH

Channel Islands Stock Exchange

CBOE

Cboe Global Markets

CY

The Cyprus Stock Exchange

DUS

Börse Dusseldorf

AEX

Euronext Amsterdam

BSE

Euronext Brussels

BVL

Euronext Lisbon

BOURSE

Euronext Paris

XLIF

Euronext.Liffe

FWB

FWB Frankfurter Wertpapierbörse

GSE

Georgian Stock Exchange

HAM

Börse Hamburg

HAN

Börse Hannover

NEX

NEX Exchange

DUBLIN

Euronext Dublin

IST

Borsa Istanbul

LATIBEX

LATIBEX

LJ

Ljubljanska Borza DD

LSE

London Stock Exchange

LuxX

Luxembourg Stock Exchange

MK

Macedonian Stock Exchange

MAD

Bolsa de Madrid

MT

Borza ta' Malta

MIL

Borsa Italiana

MNSE

Montenegro Stock Exchange

MUN

Börse Munchen

CSE

Nasdaq Copenhagen

HEX

Nasdaq Helsinki

NYXLO

Euronext London

MOEX

Moscow Exchange

ICEX

Nasdaq Iceland

STO

Nasdaq Stockholm

OAX

Oslo Axess

OSE

Oslo Børs

PRAGUE

Prague Stock Exchange

RI

Nasdaq Riga

SASE

Sarajevska Berza

SWX

SIX Swiss Exchange Ltd.

STU

Börse Stuttgart

BET

Bursa e Tiranës

TL

Nasdaq Tallinn

WBAG

Wiener Börse

LT

Nasdaq Vilnius

WSE

Warsaw Stock Exchange

GER

XETRA Stock Exchange (Germany)

ZSE

Zagrebacka burza

ASX

Australian Securities Exchange

MUMBAI

Bombay (Mumbai) Stock Exchange

MCX

MCX-SX

MYX

Bursa Malaysia

CAL

Calcutta Stock Exchange

CSEBD

Chittagong Stock Exchange Ltd.

CM

Colombo Stock Exchange

DSE

Dhaka Stock Exchange

TW

Taipei Exchange

SEHK

Hong Kong Stock Exchange

JASDAQ

JASDAQ

KA

Karachi Stock Exchange

KRX

Korea Exchange

KOE

KOSDAQ

NG

Nagoya Stock Exchange

NSI

National Stock Exchange (of India)

NZE

New Zealand Exchange

APX

Sydney Stock Exchange

PSE

Philippine Stock Exchange

PG

Port Moresby Stock Exchange

SHH

Shanghai Stock Exchange

SHZ

Shenzhen Stock Exchange

SGX

Singapore Exchange

SSXI

Indonesian Stock Exchange

TSE

Taiwan Stock Exchange

SET

Thailand Stock Exchange of

TOKYO

Tokyo Stock Exchange

HOSE

The Hochiminh Stock Exchange

ADSE

Abu Dhabi Securities Exchange

AMM

Amman Stock Exchange

BH

Bahrain Bourse

BY

Beirut Stock Exchange

BT

Botswana Stock Exchange

CS

Bourse de Casablanca

TN

Bourse de Tunis

BRVM

Bourse Regionale Des Valeurs Mobilieres S.A.

EGX

The Egyptian Exchange

DSSE

Dar es Salaam Stock Exchange

DIFX

Nasdaq Dubai

GH

Ghana Stock Exchange

JSE

Johannesburg Stock Exchange

KW

Kuwait Stock Exchange

ZM

Lusaka Stock Exchange

MSE

Malawi Stock Exchange

NR

Nairobi Stock Exchange LTD

NN

Namibian Stock Exchange

NGS

The Nigerian Stock Exchange

MZ

Stock Exchange of Mauritius

IR

Tehran Stock Exchange

SSXS

Swaziland Stock Exchange

SSE

Saudi Stock Exchange (Tadawul)

TASE

Tel-Aviv Stock Exchange

USE

Uganda Securities Exchange

ZI

Zimbabwe Stock Exchange

BS

Bahamas International Securities Exchange

BSX

Bermuda Stock Exchange

BVC

Bolsa de Valores de Colombia

BO

Bolsa Boliviana de Valores

GT

Bolsa de Valores de Guatemala

PE

Bolsa de Valores de Lima

NI

Bolsa de Valores de Nicaragua

PA

Bolsa de Valores de Panama S.A

EC

Bolsa de Valores de Quito

CR

Bolsa Nacional de Valores de Costa Rica

BCBA

Bolsa de Comercio de Buenos Aires

CAR

Bolsa de Valores de Caracas

KY

Cayman Islands Stock Exchange

JMSE

Jamaica Stock Exchange

BMV

Bolsa Mexicana de Valores

BVRJ

Bolsa de Valores do Rio de Janeiro

SGO

Bolsa de Comercio de Santiago

SAO

Bolsa de Valores Mercadorias & Futuros de Sao Paulo

TTSE

Trinidad & Tobago Stock Exchange

isin

Valid ISIN associated with the order.

socialMedia

This object contains social media details for the order.

Example:
{
  "socialMediaByLanguage": [
    {
      "language": "en",
      "suggestedTweet": "example suggested tweet",
      "socialMediaProfiles": [
        {
          "network": "Facebook",
          "name": "Facebook Profile",
          "url": "https://www.facebook.com/test",
          "type": "organization"
        }
      ],
      "hashTags": [
        "#hash"
      ],
      "cashTags": [
        "$cash"
      ]
    }
  ]
}
languageRequired

The language code for the respective social media information.

Possible enum values
en

English

es

Spanish

pt

Portuguese

de

German

fr

French

it

Italian

nl

Dutch

da

Danish

no

Norwegian

sv

Swedish

fi

Finnish

pl

Polish

cs

Czech

hu

Hungarian

et

Estonian

lv

Latvian

lt

Lithuanian

ja

Japanese

zh-HK

Chinese (Traditional)

zh-CN

Chinese (Simplified)

suggestedTweet

The suggested tweet to display for the order.

socialMediaProfiles

The object containing the data for the social media profiles.

network

The network of the social media profile.

Note: if any of the fields in this object are provided then this parameter is REQUIRED.

Possible enum values
Facebook
Twitter
LinkedIn
Pinterest
YouTube
Instagram
Other
name

The name to be associated with this profile.

Note: if any of the fields in this object are provided then this parameter is REQUIRED.

url

The url for the social media profile.

Note: if any of the fields in this object are provided then this parameter is REQUIRED.

type

The type of social media profile.

Note: if any of the fields in this object are provided then this parameter is REQUIRED.

Possible enum values
organization
hashTags

An array of strings of hash tags (Must begin with #).

cashTags

An array of strings of hash tags (Must begin with $).

sourceKeyRequired

A unique identifier to determine order source.

Note: Please reach out to your account representative to generate this key.

Example:
{
  "sourceKey": "ABCD-EFGH-QRSTU-VWXYZ"
}
posthttps://platform.businesswire.com/api/v1/clientServices/order

A multipart/form-data object would need to be passed in, which would need to contain:

{ "order": { "refreshToken": "ckkslwrpb002g01ppmfqku6qv", "workInProgress": false, "schedule": { "accountId": 1010376, "scheduleType": 3, "dateAndTime": "2020-06-29 20:49", "timezoneCode": "ET" }, "distribution": { "savedDistributionId": 2 }, "files": { "releaseText": [ { "filename": "test.txt", "language": "en" } ], "logo": [ { "filename": "logo.png", "logoUrl": "https://www.example.com" } ], "multimedia": [ { "filename": "photo.jpg", "role": 3, "captions": [ { "language": "en", "caption": "caption goes here" } ] } ] }, "details": { "requireCopyApproval": false, "specialInstructions": "example special instructions", "purchaseOrder": "example number", "pullQuotesAndTweetThis": { "disablePullQuote": false, "disableTweetBtn": false }, "releaseContact": { "contactEmail": "test@test.com", "contactPhone": "123-123-1234" }, "organizationInformation": { "securitiesIdentifier": [ { "tickerSymbol": "APPL", "exchange": "NYSE", "isin": "US0004026250" } ] }, "socialMedia": { "socialMediaByLanguage": [ { "language": "en", "suggestedTweet": "Example suggested tweet", "socialMediaProfiles": [ { "network": "Facebook", "name": "Profile Name", "url": "https://www.facebook.com/test", "type": "organization" } ], "hashTags": [ "#hash" ], "cashTags": [ "$cash" ] } ] }, "sourceKey": "ABCD-EFGH-QRSTU-VWXYZ" } } }
Response

On successful login, a statusCode of 200 will be returned and the JWT can be found in the Header with the key : x-auth-token.

A refreshToken will also be provided with the key x-refresh-token that will be used to create new access tokens.