Query Shareholder List

GET 
/v1/basic/ownership/list/:ticker

Retrieves the list of shareholders for the stock corresponding to the ticker.

Request

Path Parameters

ticker stringrequired

stock code

Query Parameters

page int32

Page Number

size int32

Page Size

sort string

Possible values: [ASC, DESC]

Default value: ASC

Sorting criterion (ASC or DESC)

Header Parameters

Accept-Country stringrequired

Default value: KR

Country Code (KR or US)

Accept-Currency string

Default value: KRW

Currency Code (KRW or USD)

Accept-Language string

Default value: EN

Language Code (KO or EN)

Responses

200

Success

application/json

Schema

Schema

data

object[]

Array [

ticker string

stock code

securityName string

Securities Name (English)

classDescription string

type of stock

classScheme string

stock classification

sharesHeld double

number of shares held

valueHeld double

value of shares held

reportedDt date-time

Report Date

shareChange double

Change in Number of Shares

reportSource string

Source of Report

valueChanged double

Changed stock amount

transactionCode string

Transaction type code

sharePercentageHeld double

Shareholding percentage

shareholderName string

Shareholder name

shareholderType string

Shareholder Type ID

shareholderCity string

Shareholder City

shareholderCountry string

Shareholder Country

shareholderStrategy string

Shareholder Investment Strategy

lastHoldingDt date

Last Holding Date

shareholderOrientation string

Shareholder Investment Orientation

]

page integer

Default value: 0

Page number (default: 0)

size integer

Default value: 5

Page size (default: 5)

totalPage integer

Default value: 0

Total number of pages

totalCount integer

Default value: 0

Total number of items

code string

Response code

status integer

Response status code

message string

Response message

timestamp string

Response timestamp

Example (from schema)

{
  "data": [
    {
      "ticker": "string",
      "securityName": "string",
      "classDescription": "string",
      "classScheme": "string",
      "sharesHeld": 0,
      "valueHeld": 0,
      "reportedDt": "2024-07-29T15:51:28.071Z",
      "shareChange": 0,
      "reportSource": "string",
      "valueChanged": 0,
      "transactionCode": "string",
      "sharePercentageHeld": 0,
      "shareholderName": "string",
      "shareholderType": "string",
      "shareholderCity": "string",
      "shareholderCountry": "string",
      "shareholderStrategy": "string",
      "lastHoldingDt": "2024-07-29",
      "shareholderOrientation": "string"
    }
  ],
  "page": 0,
  "size": 5,
  "totalPage": 0,
  "totalCount": 0,
  "code": "string",
  "status": 0,
  "message": "string",
  "timestamp": "string"
}

Loading...