The offer service provides two endpoints allowing Partners to retrieve details for the following on an ad-hoc basis:
As a best practice, PrimaryBid recommends setting up webhooks to automate the notification of offer availability to prevent the need for continuous polling.
Multiple offers
In the case where there is more than one live offer running, the PrimaryBid Connect API can support subscriptions to multiple offers in parallel.
Regional offers
Access to offers is dependent on the country jurisdiction associated with the API client account.
For example, an API client account for a Partner in France will only have access to offers originating from France.
Cross-border offer access is currently being developed as part of the product roadmap.
Offer availability
Offers will not be available for retrieval until they have been made live by PrimaryBid.
Offer type and subtype
The field offerType refers to the type of public offering used to raise funds. It can be either “primary”, “secondary”, “fixed-income”, or “IPO”.
The field offerSubtype indicates the subtype of the offer launched to raise capital.
When integrating these two fields (offerType and offerSubtype), we recommend following this logic:
- If offerType is “primary”, offerSubtype can be either “company_placing” or “investment_trust”;
- If offerType is “secondary”, offerSubtype can only be “blocks”;
- If offerType is “IPO”, offerSubtype can be “company_ipo”, “investment_trust_ipo”, “spac_ipo”, “re_ipo” or “de-spac_ipo”;
- If offerType is “fixed_income”, offerSubtype can be either “corporate_bond” or “government_bond”.
| Offer type | Offer sub-type |
|---|---|
| primary placing | company placing investment trust |
| secondary placing | blocks |
| IPO | company IPO investment trust IPO SPAC IPO re-IPO de-SPAC IPO |
| fixed income | corporate bond government bond |
Community offers
A community offer is one in which an issuer identifies and invites a group or groups of individuals to participate in the offer - either exclusively or alongside the public - and gives them preferential treatment at allocation.
These groups may include:
- Shareholders (does not apply to IPOs)
- Employees
- Account holders
- Friends & family.
PrimaryBid Community IPOs data flow
Community IPOs and membership validation
For community IPOs, issuers might require investors to prove membership status upon subscription with a membership code. This allows issuers to identify a cohort of users who may then be favourably allocated. In this case, the membershipRequired field would have the value “yes”:
[
{
"id": "64b7eaeef6edc186aa371d99",
"offerType": "ipo",
"offerSubType": "company_ipo",
"details": {
"status": "open_for_subscription",
"countryCode": "GB",
"type": "ipo",
"subType": "primary",
"estTargetRaise": 1000000,
"pressReleaseLink": "",
"membershipRequired": "yes",
"offeringDocuments": [
{
"title": "Test factsheet",
"documentUrl": "https://devoffer-assets.primarybid.com/e4c_Factsheet.pdf"
},
{
"title": "Test Key Information Document",
"documentUrl": "https://devoffer-assets.primarybid.com/123Factsheet.pdf"
}
]
},
"textProperties": {
"legalDisclaimer": "Please read our Risk Warning [/risk-warning] before subscribing.",
"title": "",
"specialInstruction": "Determine your investment goals and create a budget: Before you start investing,\nit's important to know what you want to achieve and how much you can afford to\ninvest on a regular basis. This will help you determine what types of\ninvestments to consider and how much to invest in each one Open a brokerage\naccount and choose your investments: Once you have a clear idea of your\ninvestment goals and budget, you can open a brokerage account and start choosing\nthe investments that you want to buy. There are many different types of\ninvestments to consider, so it's important to do your research and choose ones\nthat align with your goals and risk tolerance. Overall, these two steps can help\nyou get started with investing and take control of your financial future. As you\ngain more experience, you can learn more about investing and explore other\nstrategies to help you grow your money over time.",
"companyAnnouncements": "We are pleased to announce that our company will be going public through an\ninitial public offering (IPO). This is a significant milestone for our company\nand is a testament to the hard work and dedication of each and every one of you.\nGoing public will provide our company with access to new sources of capital and\nwill allow us to continue to grow and expand our operations. It will also\nprovide liquidity for our current shareholders.",
"priceless": "",
"useOfProceeds": "When a company goes public through an initial public offering (IPO), the\nproceeds are the funds that are raised through the sale of the company's stock.\nThese proceeds can be used by the company for a variety of purposes, such as\npaying off debt, investing in new projects and products, or expanding the\nbusiness. The use of proceeds is typically outlined in the company's IPO\nprospectus, which is a document that provides potential investors with\ninformation about the company and its financial performance.\nBy using the proceeds from an IPO wisely, a company can continue to grow and\nthrive in the competitive marketplace.",
"offerDiscount": null,
"restriction": "These are the conditions attached to the offer.",
"keyInformation": "This is my key information text."
},
"issuer": {
"id": "5d03a0ec67254e517f7f1fbb",
"businessDescriptionText": "ACME Global Solutions plc provides contact center services and other business\nprocess outsourcing solutions to enterprise customers. The Company's specializes\nin voice-based contact center services area where it provides a complete suite\nof voice-based services to clients.",
"companyName": "ACME Global Solutions",
"exchangeMic": "ACME",
"ticker": "ACME",
"sector": "Consumer Discretionary",
"securityIdentifier": "123ISIN456",
"fttRequired": false,
"sellerName": "",
"issuerType": "company"
},
"dates": {
"offerStartDateTime": "2023-07-19T13:59:19.783Z",
"offerEndDateTime": "2023-07-21T01:01:00.000Z",
"lastModifiedOn": "2023-07-19T13:59:19.783Z",
"admissionDateTime": null
},
"pricingAndOrderLimits": {
"acceptedCurrency": "GBP",
"priceType": "fixed",
"offerPrice": 0.0445,
"currency": "GBP",
"hardMaxLimit": 999999,
"hardMinLimit": 100,
"discount": 13,
"discountTo": null,
"discountFrom": null
}
}
]