---
title: "Point-in-time security identity and corporate-action carry"
method: GET
path: "/identity/resolve"
tags: ["Utility"]
---

# Point-in-time security identity and corporate-action carry

`GET /identity/resolve`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/identity/resolve`
- Auth: none required

Which security an identifier meant on a date, and what a holding of it became by `as_of` through reviewed corporate actions: ticker changes and reuse, ADR conversions with their ratios, splits, spin-offs and distributions, cash mergers and bankruptcy cancellations. Identity comes from reviewed event windows first, then dated ticker aliases, then the security master's current ticker, then (for a date within seven days) today's holder; a candidate contradicted by a reviewed event window is excluded. An identifier that cannot be placed returns `unavailable` or `ambiguous` rather than a guess. Every applied event carries its SEC filing. Free while reviewed coverage is limited. No API key; rate limited to 60 requests per IP per minute.

## Query parameters

- `identifier` string, required
- `as_of` string, date
- `acquired_on` string, date
- `quantity` string
- `identifier_type` 'ticker' | 'bw_sym_id'
- `known_as_of` string, date
- `fractions` 'apply' | 'exact'

## Response `200`

Identity and carried holding.

- object
  - `schema_version` string
  - `status` 'resolved' | 'ambiguous' | 'unavailable' | 'unsupported': `unsupported`: the identity resolved but the carry cannot be completed (for example a purchase between record date and distribution with no ex-date, or an election not given).
  - `coverage` 'reviewed' | 'inferred' | 'unknown': `reviewed` only when the identity came from reviewed events and every security in the answer appears in reviewed events.
  - `identity` object
    - `status` 'resolved' | 'ambiguous' | 'unavailable'
    - `source` 'bw_sym_id' | 'reviewed_event_window' | 'reviewed_event_before_first' | 'ticker_alias_window' | 'security_master_ticker' | 'current_holder', nullable
    - `bw_sym_id` string, nullable
    - `held_on` string, date
    - `candidates` object[]
    - `duplicate_records` string[]
    - `excluded_candidates` object[]
  - `result` object
    - `outcome` 'held' | 'cashed_out' | 'cancelled' | 'unknown' | 'none'
    - `holdings` object[]
    - `cash` object[]
    - `no_equity_successor` boolean
    - `cancelled_by` string[]
    - `unresolved` string[]
  - `events` object[]: Applied corporate-action events with dates, outputs and SEC source.
  - `explanation` string

## Other responses

- `400`: Invalid parameters.
- `503`: Identity data unavailable.

---

[API](https://skmtc.dev/riskmodels/apis/riskmodels-api.md) · [All operations](https://skmtc.dev/riskmodels/apis/riskmodels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/riskmodels/apis/riskmodels-api/revisions/1a034cad408a?raw)