pyocf.objects.transactions.issuance.stockissuance

Object describing a stock issuance transaction by the issuer and held by a stakeholder

pydantic model pyocf.objects.transactions.issuance.stockissuance.StockIssuance

Object describing a stock issuance transaction by the issuer and held by a stakeholder

field board_approval_date: Annotated[Date, FieldInfo(annotation=NoneType, required=True, description='Date of board approval for the security')] | None = None

field comments: Annotated[list[str], FieldInfo(annotation=NoneType, required=True, description='Unstructured text comments related to and stored for the object')] | None = None

field consideration_text: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Unstructured text description of consideration provided in exchange for securityissuance')] | None = None

field cost_basis: Annotated[Monetary, FieldInfo(annotation=NoneType, required=True, description='The cost basis for this particular stock')] | None = None

field custom_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='A custom ID for this security (e.g. CN-1.)')] [Required]

A custom ID for this security (e.g. CN-1.)

field date: Annotated[Date, FieldInfo(annotation=NoneType, required=True, description='Date on which the transaction occurred')] [Required]

Date on which the transaction occurred

field id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Identifier for the object')] [Required]

Identifier for the object

field issuance_type: Annotated[StockIssuanceType, FieldInfo(annotation=NoneType, required=True, description='Optional field to flag certain special types of issuances (like RSAs)')] | None = None

field object_type: Annotated[Literal['TX_STOCK_ISSUANCE'], FieldInfo(annotation=NoneType, required=True, description='')] = 'TX_STOCK_ISSUANCE'

field quantity: Annotated[Numeric, FieldInfo(annotation=NoneType, required=True, description='Number of shares issued to the stakeholder')] [Required]

Number of shares issued to the stakeholder

field security_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description="Identifier for the security (stock, plan security, warrant, or convertible) bywhich it can be referenced by other transaction objects. Note that while thisidentifier is created with an issuance object, it should be different than theissuance object's `id` field which identifies the issuance transaction objectitself. All future transactions on the security (e.g. acceptance, transfer,cancel, etc.) must reference this `security_id` to qualify which security thetransaction applies to.")] [Required]

Identifier for the security (stock, plan security, warrant, or convertible) bywhich it can be referenced by other transaction objects. Note that while thisidentifier is created with an issuance object, it should be different than theissuance object’s id field which identifies the issuance transaction objectitself. All future transactions on the security (e.g. acceptance, transfer,cancel, etc.) must reference this security_id to qualify which security thetransaction applies to.

field security_law_exemptions: Annotated[list[SecurityExemption], FieldInfo(annotation=NoneType, required=True, description='List of security law exemptions (and applicable jurisdictions) for this security')] [Required]

List of security law exemptions (and applicable jurisdictions) for this security

field share_numbers_issued: Annotated[list[ShareNumberRange], FieldInfo(annotation=NoneType, required=True, description='Range(s) of the specific share numbers included in this issuance. This isdifferent from a certificate number you might include in the `custom_id` fieldor the `security_id` created in this issuance. This field should be used where,for whatever reason, shares are not fungible and you must track, with eachissuance, *which* specific share numbers are included in the issuance - e.g.share numbers 1 - 100 and 250-300.')] | None = None

field share_price: Annotated[Monetary, FieldInfo(annotation=NoneType, required=True, description='The price per share paid for the stock by the holder')] [Required]

The price per share paid for the stock by the holder

field stakeholder_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Identifier for the stakeholder that holds legal title to this security')] [Required]

Identifier for the stakeholder that holds legal title to this security

field stock_class_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Identifier of the stock class for this stock issuance')] [Required]

Identifier of the stock class for this stock issuance

field stock_legend_ids: Annotated[list[str], FieldInfo(annotation=NoneType, required=True, description='List of stock legend ids that apply to this stock')] [Required]

List of stock legend ids that apply to this stock

field stock_plan_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Identifier of StockPlan the Stock was issued from (in the case of RSAs or Stockissued from a plan).')] | None = None

field stockholder_approval_date: Annotated[Date, FieldInfo(annotation=NoneType, required=True, description='Date on which the stockholders approved the security')] | None = None

field vesting_terms_id: Annotated[str, FieldInfo(annotation=NoneType, required=True, description='Identifier of the VestingTerms to which this security is subject. If neither`vesting_terms_id` or `vestings` are present then the security is fully vestedon issuance.')] | None = None

field vestings: Annotated[list[Vesting], FieldInfo(annotation=NoneType, required=True, description='List of exact vesting dates and amounts for this security. When `vestings` arrayis present then `vesting_terms_id` may be ignored.')] | None = None