top

Transactions

Transactions module introduces an Investment Transaction Registration and Filtering feature, empowering users to seamlessly record and manage their investment transactions. Whether you are an individual investor or a financial professional, this powerful tool will help you keep track of your investments and analyze their performance with ease. Key functionalities of this feature: Investment Transaction Registration:, Advanced Filtering Options : Date Range, Investment Type, Buyer/Seller Entity, Security Type. Transaction Listing and Export : users have the option to export the transaction data in various formats, such as CSV or PDF. Data Visualization : To enhance the user experience and aid in better decision-making, the application provides visually appealing charts and graphs to represent investment performance trends over time.

Retrieve all transactions

Retrieve a list of transactions based on your query parameters.

Get/transactions

Query Parameters

before_created_at
TYPEstring
Restrict the response to entities created_at before the set time.

after_created_at
TYPEstring
Restrict the response to transactions created_at after the set time.

before_updated_at
TYPEstring
Restrict the response to transactions updated_at before the set time.

after_updated_at
TYPEstring
Restrict the response to transactions updated_at after the set time.

before_announced_at
TYPEstring
Restrict the response to transactions announced_at before the set time.

after_announced_at
TYPEstring
Restrict the response to transactions announced_at after the set time.

before_closed_at
TYPEstring
Restrict the response to transactions closed_at before the set time.

after_closed_at
TYPEstring
Restrict the response to transactions closed_at after the set time.

name
TYPEstring
Restrict the response to transactions with the search phrase in the name field.

buyer_entity_id
TYPEstring
Restrict the response to transactions purchased by an entity. Use a valid entity_id.

buyer_entity_type
TYPEstring
Restrict the response to transactions where the buyer's entity_type matches the value provided. See Entity Types for a full list.

seller_entity_id
TYPEstring
Restrict the response to transactions sold by an entity_id. Use a valid entity_id.

seller_entity_type
TYPEstring
Restrict the response to transactions where the seller's entity_type matches the value provided. See Entity Types for a full list.

amount_gte
TYPEinteger
Restrict the response to transactions where the amount field is greater than or equal to the value provided.

amount_lte
TYPEinteger
Restrict the response to transactions where the amount field is less than or equal to the value provided.

country
TYPEstring
Restrict the response to transactions that match the specific country provided. See Countries for a list of all values.

region
TYPEstring
Restrict the response to transactions that match the specific region provided. See Regions for a list of all values.

aquisition_type
TYPEstring
Restrict the response to transactions that match the specific aquisition_type provided. Possible values: "Deal", "Fund Investment", "New Security Issue", "Open Market", "Outsourced CIO", and "Sub Advisory".

security_type
TYPEstring
Restrict the response to transactions that match the specific security_type provided. See Security Types for a full list.

investment_type
TYPEstring
Restrict the response to transactions that match the specific investment_type provided. See Investment Types for a full list.

sector
TYPEstring
Restrict the response to transactions that match the specific sector provided. See Sectors for a full list.

industry
TYPEstring
Restrict the response to transactions that match the specific industry provided. See Industries for a full list.

limit
TYPEinteger
The number of records to return. Default value is 10. Maximum value is 100.

offset
TYPEinteger
Used for pagination, this is the number of records from a collection to skip. Default value is 0.

sort_field
TYPEstring
Returns files sorted by the specified field. Possible values: "created_at" or "updated_at". Default is "created_at".

sort_dir
TYPEstring
Determines the order direction for sorted results. Possible values: "ASC" or "DESC". Default is "DESC".
List Transactions
curl -v -X GET https://api.swfi.com/v1/transactions?before_created_at=2022-10-17&after_created_at=2022-10-12&before_updated_at=2022-10-17&after_updated_at=2022-10-12&before_announced_at=2022-10-17&after_announced_at=2022-10-12&before_closed_at=2022-10-17&after_closed_at=2022-10-12&name=Ingram%20Micro&buyer_entity_id=598cdaa50124e9fd2d05b5f2&buyer_entity_type=Company&seller_entity_id=598cdaa50124e9fd2d05a8be&seller_entity_type=Bank&amount_gte=50000000&amount_lte=70000000&country=Norway&region=North%20America&aquisition_type=Fund%20Investment&security_type=Convertible%20Preferred%20Stock&investment_type=Convertible&sector=Consumer%20Discretionary&industry=Consumer%20Discretionary&limit=10&offset=0&sort_field=created_at&sort_dir=ASC \ 
-H "Accept: application/json" \ 
-H "Authorization: $API_KEY"

Success Response

HTTP Status 200
data
TYPEobject[]
An array of transactions.

total_items
TYPEinteger
The total number of items matching the query regardless of pagination.
Example response
{
  "data": [
    {
      "_id": "5b56702d3936750eee0e4d1c",
      "name": "North Sea Midstream Partners Limited",
      "aquisition_type": "Deal",
      "security_type": "Ordinary Shares",
      "investment_type": "Unlisted Equity",
      "sector": "Infrastructure",
      "industry": "Pipelines",
      "amount": 1706070000,
      "amount_native": 1300000000,
      "currency": "GBP",
      "summary": "<p>Wren House Infrastructure Management, the internal infrastructure unit of the Kuwait Investment Authority (KIA), signed an agreement to acquire the oil and gas pipeline firm North Sea Midstream Partners Limited for approximately 1.3 billion GBP. The seller of the firm is ArcLight Capital Partners, LLC. Other bidders for the company include Blackstone Group, KKR and JPMorgan. North Sea Midstream Partners was created in 2012 by affiliates of ArcLight Capital Partners LLC, Mike Wagstaff (the former CEO of Venture Production plc) and the senior management of Teesside Gas Processing Plant Limited (including CEO Andy Heppel) to invest in the midstream sector of the North Sea&rsquo;s oil and gas industry.</p>\n<p>North Sea Midstream Partners owns a 67% ownership stake in the Shetland Islands Regional Gas Evacuation System (SIRGES) pipeline that transports natural gas from the West of Shetlands basin. The holding company also owns a 100% interest in the FUKA pipeline which transports gas from the SIRGE pipeline and various fields in the Northern and Central North Sea. In addition, North Sea Midstream Partners owns the St. Fergus Gas Terminal and Teesside Gas Processing Plant. North Sea Midstream Partners owns a piece of the Rhum gas field, in the North Sea and which is 50% owned by the Iranian Oil Company.</p>\n<p>The financial advisor for ArcLight Capital was Bank of America Merrill Lynch, while the legal advisor was Freshfields Bruckhaus Deringer was its legal adviser. Wren House Infrastructure was advised by Jefferies and Macquarie Capital. Wren House Infrastructure&rsquo;s legal advisor was Slaughter and May.</p>",
      "country": "United Kingdom",
      "region": "Europe",
      "announced_at": "2018-07-23T00:00:00.000Z",
      "closed_at": "2018-07-23T00:00:00.000Z",
      "mandate_closed_at": "",
      "buyer_entities": [
        {
          "name": "Kuwait Investment Authority",
          "type": "Sovereign Wealth Fund",
          "entity_id": "598cdaa50124e9fd2d05b5f2",
          "percentage_post": 1,
          "percentage_purchased": "",
          "percentage_acquired": ""
        }
      ],
      "buyer_subsidiaries": [
        {
          "name": "Wren House Infrastructure Management",
          "type": "Asset Manager",
          "subsidiary_id": "59b705ff0124e9fd2d192034",
          "parent_entity_id": "598cdaa50124e9fd2d05b5f2"
        }
      ],
      "buyer_advisors_legal": [
        {
          "name": "Slaughter & May",
          "advisor_id": "5963b1230124e9fd2dfb32ac",
          "advised_entity_id": "598cdaa50124e9fd2d05b5f2"
        }
      ],
      "buyer_advisors_financial": [
        {
          "name": "Macquarie",
          "advisor_id": "5963b1230124e9fd2dfb337e",
          "advised_entity_id": "598cdaa50124e9fd2d05b5f2"
        },
        {
          "name": "Jefferies",
          "advisor_id": "5963b1230124e9fd2dfb3364",
          "advised_entity_id": "598cdaa50124e9fd2d05b5f2"
        }
      ],
      "seller_entities": [
        {
          "name": "Arclight Capital Partners LLC",
          "type": "Asset Manager",
          "entity_id": "598cdaa50124e9fd2d05a8be",
          "percentage_post": "",
          "percentage_sold": 1,
          "percentage_disposed": 1
        }
      ],
      "seller_subsidiaries": [],
      "seller_advisors_legal": [
        {
          "name": "Freshfields",
          "advisor_id": "5963b1230124e9fd2dfb3252",
          "advised_entity_id": "598cdaa50124e9fd2d05a8be"
        }
      ],
      "seller_advisors_financial": [
        {
          "name": "Bank of America Merrill Lynch",
          "advisor_id": "5963b1230124e9fd2dfb32df",
          "advised_entity_id": "598cdaa50124e9fd2d05a8be"
        }
      ],
      "updated_at": "2018-08-02T05:20:35.643Z",
      "created_at": "2018-07-24T00:17:49.040Z"
    },
    {
      "_id": "59d98f56e53bd6206ec52b5c",
      "name": "8 Canada Square, HSBC Tower",
      "aquisition_type": "Deal",
      "security_type": "Leasehold Interest",
      "investment_type": "Real Estate",
      "sector": "Real Estate",
      "industry": "Office",
      "amount": 1279810000,
      "amount_native": 772500000,
      "currency": "GBP",
      "summary": "<p>HSBC Bank plc, a wholly owned subsidiary of HSBC Holdings plc, has agreed the sale of 8 Canada Square, Canary Wharf ,&nbsp; London to the National Pension Service of Korea (NPS), through NPS 8CS Holdings Sarl, for &pound;772.5 million in cash. NPS 8CS Holdings Sarl is buying a 100% in Project Maple II B.V., the sole asset of which is the 998-year leasehold interest in 8 Canada Square. Under the terms of the agreement, HSBC will retain full control of occupancy for the remaining 17.5 years of the existing 20 year leaseback period at a current rent of &pound;46 million per annum.&nbsp;&nbsp;CB Richard Ellis Limited and Linklaters LLP acted for HSBC, and JP Morgan Asset Management and Berwin Leighton Paisner acted for NPS in this transaction.</p>",
      "country": "United Kingdom",
      "region": "Europe",
      "announced_at": "2009-11-13T00:00:00.000Z",
      "closed_at": "2009-11-13T00:00:00.000Z",
      "mandate_closed_at": "",
      "buyer_entities": [
        {
          "name": "National Pension Service of Korea",
          "type": "Public Pension",
          "entity_id": "598cdaa60124e9fd2d05b8e6",
          "percentage_post": 1,
          "percentage_purchased": "",
          "percentage_acquired": ""
        }
      ],
      "buyer_subsidiaries": [
        {
          "name": "NPS 8CS Holdings Sarl",
          "type": "Company",
          "subsidiary_id": "59d98fe759ae3f2b27d64c8f",
          "parent_entity_id": "598cdaa60124e9fd2d05b8e6"
        }
      ],
      "buyer_advisors_legal": [
        {
          "name": "Berwin Leighton Paisner",
          "advisor_id": "5963b1230124e9fd2dfb3222",
          "advised_entity_id": "598cdaa60124e9fd2d05b8e6"
        }
      ],
      "buyer_advisors_financial": [
        {
          "name": "JPMorgan",
          "advisor_id": "5963b1230124e9fd2dfb3369",
          "advised_entity_id": "598cdaa60124e9fd2d05b8e6"
        }
      ],
      "seller_entities": [
        {
          "name": "HSBC Holdings",
          "type": "Bank",
          "entity_id": "598cdaa50124e9fd2d05b3cb",
          "percentage_post": "",
          "percentage_sold": 1,
          "percentage_disposed": 1
        }
      ],
      "seller_subsidiaries": [
        {
          "name": "HSBC Bank plc",
          "type": "Bank",
          "subsidiary_id": "59d98fbdc308792b2d062b5f",
          "parent_entity_id": "598cdaa50124e9fd2d05b3cb"
        }
      ],
      "seller_advisors_legal": [
        {
          "name": "Linklaters",
          "advisor_id": "5963b1230124e9fd2dfb3279",
          "advised_entity_id": "598cdaa50124e9fd2d05b3cb"
        }
      ],
      "seller_advisors_financial": [
        {
          "name": "CBRE",
          "advisor_id": "5963b1230124e9fd2dfb32fb",
          "advised_entity_id": "598cdaa50124e9fd2d05b3cb"
        }
      ],
      "updated_at": "2017-10-08T02:40:51.054Z",
      "created_at": "2017-10-08T02:37:10.743Z"
    }
  ],
  "total_items": 98269
}

Error Response

message
TYPEstring
A short, human-readable summary of the problem type.

status
TYPEinteger
The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurance of the problem.
Example response
{
  "errors": [
      {
          "query_parameter": "sort_field",
          "message": "Value not in available options."
      }
  ],
  "status": 400
}

Retrieve one transaction

Retrieve one transaction with links to associated resources.

Get/transactions/:_id

Path Parameters

_id
REQUIRED
TYPEstring
Get information about a specific transaction.
Get Transaction info
curl -v -X GET https://api.swfi.com/v1/transactions/:_id \ 
-H "Accept: application/json" \ 
-H "Authorization: $API_KEY"

Success Response

HTTP Status 200
data._id
TYPEstring
Unique identifier for the transaction.

data.name
TYPEstring
Familiar name of the transaction.

data.aquisition_type
TYPEstring
The SWFI aquisition type classification for the transaction. Possible values: Deal, Fund Investment, New Security Issue, Open Market, Outsourced CIO, and Sub Advisory.

data.security_type
TYPEstring
The SWFI security type classification for the transaction. See Security Types for a full list.

data.investment_type
TYPEstring
The SWFI investment type classification for the transaction. See Investment Types for a full list.

data.sector
TYPEstring
The sector for the transaction. See Sectors for a full list.

data.industry
TYPEstring
The industry for the transaction. See Industries for a full list.

data.amount
TYPEnumber
The USD amount of the transaction. Field can be an empty string.

data.amount_native
TYPEnumber
The value based on the native currency of the record. Field can be 0 or an empty string.

data.currency
TYPEstring
The currency abbreviation for the amount_native field.

data.country
TYPEstring
The specific country where the transaction resides. See Countries for a list of all values.

data.region
TYPEstring
The specific region where the transaction resides. See Regions for a full list.

data.summary
TYPEstring
General summary of the transaction in HTML markup.

data.announced_at
TYPEstring
When the transaction was publicly available. Field can be an empty string

data.closed_at
TYPEstring
When the transaction was finalized. Field can be an empty string

data.mandate_closed_at
TYPEstring
When the transation mandate was finalized. Field can be an empty string

data.seller_entities
TYPEobject[]
List of seller(s) for the transaction, as well as shareholding percentage pre and post transaction. This field can be an empty list.

data.seller_subsidiaries
TYPEobject[]
List of seller subsidiaries for the transaction. This field can be an empty list.

data.seller_advisors_legal
TYPEobject[]
List of legal advisors that helped each seller entity for the transaction. This field can be an empty list.

data.seller_advisors_financial
TYPEobject[]
List of financial advisors that helped each seller entity for the transaction. This field can be an empty list.

data.buyer_entities
TYPEobject[]
List of buyer(s) for the transaction, as well as shareholding percentage pre and post transaction.

data.buyer_subsidiaries
TYPEobject[]
List of buyer subsidiaries for the transaction. This field can be an empty list.

data.buyer_advisors_legal
TYPEobject[]
List of legal advisors that helped each buyer entity for the transaction. This field can be an empty list.

data.buyer_advisors_financial
TYPEobject[]
List of financial advisors that helped each buyer entity for the transaction. This field can be an empty list.

data.updated_at
TYPEstring
The last time the transaction received one or more updates. Field can be an empty string.

data.created_at
TYPEstring
When the transaction was created.
Example response
{
  "data": {
    "_id": "59d98f56e53bd6206ec52b5c",
    "name": "8 Canada Square, HSBC Tower",
    "aquisition_type": "Deal",
    "security_type": "Leasehold Interest",
    "investment_type": "Real Estate",
    "sector": "Real Estate",
    "industry": "Office",
    "amount": 1279810000,
    "amount_native": 772500000,
    "currency": "GBP",
    "summary": "<p>HSBC Bank plc, a wholly owned subsidiary of HSBC Holdings plc, has agreed the sale of 8 Canada Square, Canary Wharf ,&nbsp; London to the National Pension Service of Korea (NPS), through NPS 8CS Holdings Sarl, for &pound;772.5 million in cash. NPS 8CS Holdings Sarl is buying a 100% in Project Maple II B.V., the sole asset of which is the 998-year leasehold interest in 8 Canada Square. Under the terms of the agreement, HSBC will retain full control of occupancy for the remaining 17.5 years of the existing 20 year leaseback period at a current rent of &pound;46 million per annum.&nbsp;&nbsp;CB Richard Ellis Limited and Linklaters LLP acted for HSBC, and JP Morgan Asset Management and Berwin Leighton Paisner acted for NPS in this transaction.</p>",
    "country": "United Kingdom",
    "region": "Europe",
    "announced_at": "2009-11-13T00:00:00.000Z",
    "closed_at": "2009-11-13T00:00:00.000Z",
    "mandate_closed_at": "",
    "buyer_entities": [
      {
        "name": "National Pension Service of Korea",
        "type": "Public Pension",
        "entity_id": "598cdaa60124e9fd2d05b8e6",
        "percentage_post": 1,
        "percentage_purchased": "",
        "percentage_acquired": ""
      }
    ],
    "buyer_subsidiaries": [
      {
        "name": "NPS 8CS Holdings Sarl",
        "type": "Company",
        "subsidiary_id": "59d98fe759ae3f2b27d64c8f",
        "parent_entity_id": "598cdaa60124e9fd2d05b8e6"
      }
    ],
    "buyer_advisors_legal": [
      {
        "name": "Berwin Leighton Paisner",
        "advisor_id": "5963b1230124e9fd2dfb3222",
        "advised_entity_id": "598cdaa60124e9fd2d05b8e6"
      }
    ],
    "buyer_advisors_financial": [
      {
        "name": "JPMorgan",
        "advisor_id": "5963b1230124e9fd2dfb3369",
        "advised_entity_id": "598cdaa60124e9fd2d05b8e6"
      }
    ],
    "seller_entities": [
      {
        "name": "HSBC Holdings",
        "type": "Bank",
        "entity_id": "598cdaa50124e9fd2d05b3cb",
        "percentage_post": "",
        "percentage_sold": 1,
        "percentage_disposed": 1
      }
    ],
    "seller_subsidiaries": [
      {
        "name": "HSBC Bank plc",
        "type": "Bank",
        "subsidiary_id": "59d98fbdc308792b2d062b5f",
        "parent_entity_id": "598cdaa50124e9fd2d05b3cb"
      }
    ],
    "seller_advisors_legal": [
      {
        "name": "Linklaters",
        "advisor_id": "5963b1230124e9fd2dfb3279",
        "advised_entity_id": "598cdaa50124e9fd2d05b3cb"
      }
    ],
    "seller_advisors_financial": [
      {
        "name": "CBRE",
        "advisor_id": "5963b1230124e9fd2dfb32fb",
        "advised_entity_id": "598cdaa50124e9fd2d05b3cb"
      }
    ],
    "updated_at": "2017-10-08T02:40:51.054Z",
    "created_at": "2017-10-08T02:37:10.743Z"
  }
}

Error Response

message
TYPEstring
A short, human-readable summary of the problem type.

status
TYPEinteger
The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurance of the problem.
Example response
{
  "errors": [
      {
          "path": "/v1/aum/:_id",
          "message": "Not Found"
      }
  ],
  "status": 404
}
Documentation as of 10/19/2022