Company profile
Company profile
GET
/openapi/v3/parties/{ref}/profileRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
Applicability: US equities only. Perpetual futures have no issuer. This group hangs off the issuer (
/parties), not the stock. For the rationale see the resource model.Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ref | string | Required | Issuer reference. A full_symbol such as AAPL.US is recommended; a stable party_id also works |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/parties/AAPL.US/profile" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.profile:
| Field | Type | Description |
|---|---|---|
| sector / industry / gic_sector | String | Classification codes |
| employees | Number | Employee count |
| description | String | Company description (supports ?lang=) |
| website / logo_url | String | Website / logo (full hot-linkable URLs) |
| ipo_date | String | IPO date |
| isin | String | International Securities Identification Number |
| fiscal_year_end | String | Fiscal-year-end month, e.g. December |
| headquarters | String | Headquarters address |
| officers[] | Array | Executives { name, title } (title supports ?lang=) |
| ceo | String | Current CEO name (honorifics stripped — use directly across languages, don't match it yourself) |
Notes
- If the issuer exists but its profile has not been loaded,
data.profileisnull(not a 404). - Batch version:
GET /profiles?refs=A,B,C(≤ 50).data.profilesis keyed by the input refs verbatim; each value is the table above flattened plusparty_id. Failed items go towarnings(note this differs from the singular endpoint'snullsemantics).