> ## Documentation Index > Fetch the complete documentation index at: https://docs.tickdb.ai/llms.txt > Use this file to discover all available pages before exploring further. # Corporate Actions > Retrieve stock splits, reverse splits, rights issues, symbol changes, and other corporate-action events. ## Plan Access | Plan | Available | | - | :-: | | Free | ❌ | | Starter | ✅ | | Professional | ✅ | | Full-Market Plans (A-Shares, HK Stocks, US Stocks) | ✅ | | Enterprise | ✅ | ## Notes * Corporate actions may span multiple historical dates. `is_recent` marks a recent event and does not mean it occurred on the query date. ## Supported Markets | Market | Examples | | - | - | | US Stocks | AAPL.US | | HK Stocks | 700.HK | | A-Shares | 600519.SH | ## Request Parameters | Parameter | Required | Description | | - | :-: | - | | `symbol` | Yes | Stock symbol | | `type` | No | Product type; currently supports `stock` | | `from` | No | Start date in `YYYY-MM-DD` format | | `to` | No | End date in `YYYY-MM-DD` format | ## Request Example ```bash theme={null} curl -H "X-API-Key: YOUR_API_KEY" \ "https://api.tickdb.ai/v1/fundamentals/corp-actions?symbol=AAPL&type=stock" ``` ## Response Fields The table below lists fields in `data`; an outer `code=0` indicates success. | Field | Description | | - | - | | symbol | Stock symbol. | | events | Corporate-action events. | | └─ event\_id | Event ID. | | └─ action\_code | Action code. | | └─ act\_type | Action type. | | └─ act\_desc | Action description. | | └─ event\_date | Event date in `YYYY-MM-DD` format. | | └─ date\_type | Date type. | | └─ date\_zone | Time zone. | | └─ is\_recent | Whether this is a recent event. | Returns event dates, event types, action codes, and descriptions for corporate actions. ## OpenAPI ````yaml openapi.en.yaml GET /v1/fundamentals/corp-actions openapi: 3.1.0 info: title: TickDB API description: TickDB unified real-time market data API via REST and WebSocket. version: 1.0.3 contact: email: support@tickdb.ai servers: - url: https://api.tickdb.ai description: Production server security: - ApiKeyAuth: [] paths: /v1/fundamentals/corp-actions: get: tags: - fundamentals-capital-actions summary: Corporate Actions description: >- Retrieve stock splits, reverse splits, rights issues, symbol changes, and other corporate-action events. operationId: getFundamentalsCorporateActions parameters: - $ref: '#/components/parameters/SymbolQuery' - $ref: '#/components/parameters/TypeQuery' - $ref: '#/components/parameters/FromQuery' - $ref: '#/components/parameters/ToQuery' responses: '200': $ref: '#/components/responses/CorporateActionsResponse' default: $ref: '#/components/responses/ErrorResponse' components: parameters: SymbolQuery: name: symbol in: query required: true schema: type: string examples: - AAPL - '700' - '600519' - AAPL.US - 700.HK - 600519.SH description: Stock symbol TypeQuery: name: type in: query required: false schema: type: string enum: - stock description: Product type; currently supports `stock` FromQuery: name: from in: query required: false schema: type: string format: date examples: - '2024-01-01T00:00:00.000Z' description: Start date in `YYYY-MM-DD` format ToQuery: name: to in: query required: false schema: type: string format: date examples: - '2026-12-31T00:00:00.000Z' description: End date in `YYYY-MM-DD` format responses: CorporateActionsResponse: description: Corporate Actions response. content: application/json: schema: $ref: '#/components/schemas/CorporateActionsEnvelope' ErrorResponse: description: >- Error response. Common HTTP statuses include 400 (invalid parameters), 401 (authentication failed), 403 (permission or quota restriction), 404 (no matching data), 429 (rate limit), and 503 (service temporarily unavailable). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: missingAPIKey: summary: Missing API key value: code: '1002' message: API key is required. Provide via X-API-Key header error: '1002' missingKind: summary: Missing required parameter value: code: 40001 message: kind is required data: null endpointForbidden: summary: API key cannot access this endpoint value: code: 3009 message: This endpoint is not allowed for your API key data: null marketForbidden: summary: API key cannot access this market value: code: 3010 message: Fundamentals market not allowed for your API key data: market: US noAvailableSource: summary: Data temporarily unavailable value: code: 5003 message: Data is temporarily unavailable data: null notFound: summary: No matching data value: code: 40404 message: shareholder detail not found data: null businessNoData: summary: No business data matches the query value: code: 40405 message: valuation time series not found data: null schemas: CorporateActionsEnvelope: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: $ref: '#/components/schemas/CorporateActionsData' ErrorEnvelope: type: object required: - code - message properties: code: description: >- TickDB API business error code; may be an integer or string. Convert it to a string before comparing. oneOf: - type: integer - type: string message: type: string description: Error description. error: type: string description: >- Compatibility error identifier; present only in some error responses. data: description: Optional error context; may be null, an object, or an array. oneOf: - type: 'null' - type: object additionalProperties: true - type: array items: {} SuccessEnvelope: type: object required: - code - data properties: code: type: integer const: 0 description: Business status code; `0` means success. CorporateActionsData: type: object required: - symbol - events properties: symbol: type: string description: Stock symbol. events: type: array description: Corporate-action events. items: $ref: '#/components/schemas/CorporateActionItem' additionalProperties: true CorporateActionItem: type: object required: - event_id - event_date - date_type - date_zone - act_type - act_desc - action_code - is_recent properties: event_id: type: string description: Event ID. event_date: type: string format: date description: Event date in `YYYY-MM-DD` format. date_type: type: string description: Date type. date_zone: type: string description: Time zone. act_type: type: string description: Action type. act_desc: type: string description: Action description. action_code: type: string description: Action code. is_recent: type: boolean description: Whether this is a recent event. additionalProperties: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.