Markets data API

Use the navigation to explore the various endpoints available on the Companies API suite. Each endpoint section hosts its own documentation and demo area to help in forming more complicated requests.

Overview

The Companies API suite makes available company specific collections of data. All endpoints require a symbols parameter. Symbols of securities will be matched when possible to the underlying company. There are often multiple securities issued by companies, so this not a one to one relationship. For example, supplying PSO:NYQ or PSON:LSE in the symbols param will return data on the same company. This differs from the Securities API where the data is security specific and symbols are matched to individual securities.

Director Dealings

get /v1/directordealings

Returns director transactions data for the company

ParamWhereExampleDescriptionRequired?
symbolsQuerystringpson:lse,aapl:nsqComma separated list of symbols to match on. Valid symbol sets include FTStandard, Bridge, Street & ISIN symbols.yes
transTypeQuerystring'Purchase' or 'Sale'The type of transaction to filter byno
startDateQuerystring2014-09-01Start date for the time period in ISO formatno
sortFieldQuerystringstartDateSorts the results by the given value. Valid Inputs: date, price, numShares, transType, officerno
sortDirQuerystringascDetermines the sort direction. "asc" for ascending or "desc" for descending order.no
limitQuerystring10Number of results returned. May be used in conjuction with offset for paging.no
offsetQuerystring0Zero based index to start results returned. May be used in conjuction with limit for paging.no
Example Requests
Auto-generated example using only required fields
//markets.ft.com/research/webservices/companies/v1/directordealings?symbols=pson:lse,aapl:nsq&source=befd8ca75ac4a20e
Output

Playground

//markets.ft.com/research/webservices/companies/v1/directordealings?
Code goes here
Use this form to generate a query. Blank inputs will be excluded.
Comma separated list of symbols to match on. Valid symbol sets include FTStandard, Bridge, Street & ISIN symbols.
symbols=
The type of transaction to filter by
transType=
Start date for the time period in ISO format
startDate=
Sorts the results by the given value. Valid Inputs: date, price, numShares, transType, officer
sortField=
Determines the sort direction. "asc" for ascending or "desc" for descending order.
sortDir=
Number of results returned. May be used in conjuction with offset for paging.
limit=
Zero based index to start results returned. May be used in conjuction with limit for paging.
offset=

Change log

  • 1.1.1Released on 15 January 2015

    Adds filter support for 'officer' and 'position'; Fixes bug in the 'limit' and 'offset' params; Adds default sort of date.

  • 1.2.0Released on 15 January 2015

    Returns total items for paging

Officers

get /v1/officers

Returns officer list with their corresponding start date and historic quote open, close price

ParamWhereExampleDescriptionRequired?
symbolsQuerystringpson:lse,aapl:nsqComma separated list of symbols to match on. Valid symbol sets include FTStandard, Bridge, Street & ISIN symbols.yes
Example Requests
Auto-generated example using only required fields
//markets.ft.com/research/webservices/companies/v1/officers?symbols=pson:lse,aapl:nsq&source=befd8ca75ac4a20e
Output

Playground

//markets.ft.com/research/webservices/companies/v1/officers?
Code goes here
Use this form to generate a query. Blank inputs will be excluded.
Comma separated list of symbols to match on. Valid symbol sets include FTStandard, Bridge, Street & ISIN symbols.
symbols=

Profile

get /v1/profile

Returns company profile data such as description, contact information, etc..

ParamWhereExampleDescriptionRequired?
symbolsQuerystringpson:lse,aapl:nsqComma separated list of symbols to match on. Valid symbol sets include FTStandard, Bridge, Street & ISIN symbols.yes
Example Requests
Auto-generated example using only required fields
//markets.ft.com/research/webservices/companies/v1/profile?symbols=pson:lse,aapl:nsq&source=befd8ca75ac4a20e
Output

Playground

//markets.ft.com/research/webservices/companies/v1/profile?
Code goes here
Use this form to generate a query. Blank inputs will be excluded.
Comma separated list of symbols to match on. Valid symbol sets include FTStandard, Bridge, Street & ISIN symbols.
symbols=