Reference.corporate_actions.list_events

Requests documentation for all supported corporate action event types, including their fields, subtypes, and applicable calendar dates.

Returns

dict[str, dict]

The raw JSON response as a dict keyed by event code (e.g. AGM), where each value is:

Field
Type
Description
calendar_dates
list[dict] or None
The calendar dates relevant to the event.
category
str or None
The category of the event (distribution, distribution_debit, legal_action, proposal, reorganisation, static_reference, tax_related, other).
code
str or None
The code for the event (e.g. AGM).
description
str or None
Description of the event.
fields
list[dict] or None
The fields relevant to the event.
level
str
The level the event applies to (country, issuer, listing, security).
name
str
Name of the event.
participation
str or None
Whether the event is mandatory, voluntary, or a mix of the two (mandatory, voluntary, mandatory_voluntary).
subtypes
list[dict] or None
The subtypes relevant to the event.
See also

Corporate actions events guide for information in text form.

API method 
1
Reference.corporate_actions.list_events() -> dict[str, dict]
Example usage 
1
2
3
4
5
6
7
import databento as db

client = db.Reference("$YOUR_API_KEY")

event_docs = client.corporate_actions.list_events()

print(event_docs["AGM"])
Example response 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
{
    "code": "AGM",
    "name": "Company Meeting",
    "level": "issuer",
    "category": "proposals",
    "participation": "voluntary",
    "description": "Annual General meeting of shareholders is held once a year, usually after the end of the financial year. Also includes other meeting types such as Extraordinary General Meeting, Special General Meeting, Court Ordered Meeting, and Postal Ballot.",
    "subtypes": [
        {
            "code": "AGM",
            "description": "Annual General Meeting"
        },
        {
            "code": "BHM",
            "description": "Bond Holder Meeting"
        },
        {
            "code": "CGM",
            "description": "Court Ordered General Meeting"
        },
        {
            "code": "EGM",
            "description": "Extraordinary General Meeting"
        },
        {
            "code": "GM",
            "description": "General Meeting"
        },
        {
            "code": "SGM",
            "description": "Special General Meeting"
        }
    ],
    "calendar_dates": [
        {
            "name": "event_date",
            "alias": "meeting_date"
        },
        {
            "name": "effective_date",
            "alias": "meeting_date"
        }
    ],
    "fields": [
        {
            "group": "event_info",
            "name": "meeting_number",
            "description": "Company Meeting Number"
        },
        {
            "group": "event_info",
            "name": "meeting_time",
            "description": "Local time for Start of Meeting"
        },
        {
            "group": "event_info",
            "name": "address_line1",
            "description": "Address line 1"
        },
        {
            "group": "event_info",
            "name": "address_line2",
            "description": "Address line 2"
        },
        {
            "group": "event_info",
            "name": "address_line3",
            "description": "Address line 3"
        },
        {
            "group": "event_info",
            "name": "address_line4",
            "description": "Address line 4"
        },
        {
            "group": "event_info",
            "name": "address_line5",
            "description": "Address line 5"
        },
        {
            "group": "event_info",
            "name": "address_line6",
            "description": "Address line 6"
        },
        {
            "group": "event_info",
            "name": "city",
            "description": "City"
        },
        {
            "group": "event_info",
            "name": "country",
            "description": "Country Code - ISO 3166-1"
        }
    ]
}