Get investments associated with a specific STO ID
curl --request GET \
--url https://api.sandbox.brickken.com/get-investments-by-sto-id \
--header 'x-api-key: <api-key>'import requests
url = "https://api.sandbox.brickken.com/get-investments-by-sto-id"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.brickken.com/get-investments-by-sto-id', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.brickken.com/get-investments-by-sto-id",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.brickken.com/get-investments-by-sto-id"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.brickken.com/get-investments-by-sto-id")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.brickken.com/get-investments-by-sto-id")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"offeringTransactionsList": [
{
"id": "42594b34-1c1f-4e03-9dd2-78b16ff9826e",
"date": "2024-06-06T09:35:43.106Z",
"user": "investor.email@example.com",
"amountInUSD": "500.00",
"status": "invest",
"txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"currency": "USDC"
}
],
"total": 42
}Read Endpoints
Get Investments by STO
Description: This endpoint retrieves a list of investment transactions associated with a specific Security Token Offering (STO), identified by its UUID.
Headers:
x-api-key:YOUR_API_KEY
Query Parameters:
tokenSymbol(string): The symbol of the token.id(string, format: uuid): The unique identifier of the STO for which to retrieve investments.
GET
/
get-investments-by-sto-id
Get investments associated with a specific STO ID
curl --request GET \
--url https://api.sandbox.brickken.com/get-investments-by-sto-id \
--header 'x-api-key: <api-key>'import requests
url = "https://api.sandbox.brickken.com/get-investments-by-sto-id"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.sandbox.brickken.com/get-investments-by-sto-id', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.brickken.com/get-investments-by-sto-id",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.brickken.com/get-investments-by-sto-id"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.brickken.com/get-investments-by-sto-id")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.brickken.com/get-investments-by-sto-id")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"offeringTransactionsList": [
{
"id": "42594b34-1c1f-4e03-9dd2-78b16ff9826e",
"date": "2024-06-06T09:35:43.106Z",
"user": "investor.email@example.com",
"amountInUSD": "500.00",
"status": "invest",
"txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"currency": "USDC"
}
],
"total": 42
}Lists the investment transactions recorded for one offering.
An unknown or unmatched offering
Query Parameters
tokenSymbol(required): Token symbolid(required): Offeringuuid, as returned byGET /get-stos
Example
curl --request GET \
--url 'https://api.sandbox.brickken.com/get-investments-by-sto-id?tokenSymbol=EXMPL&id=a5232594-3f97-47d0-b362-491caac9388f' \
--header 'x-api-key: YOUR_API_KEY'
Response
{
"offeringTransactionsList": [
{
"id": "b8341970-b99d-4c75-929c-854ab746723e",
"date": "2026-08-10T12:00:00.000Z",
"txHash": "0xae08674018f81ce617aa8b6c4d582a681b278542cf30921536b91b2162fe19fb",
"user": "investor@example.com",
"currency": "USDC",
"amountInUSD": "100.0",
"status": "invest"
}
],
"total": 1
}
id returns an empty list with total: 0 rather than an error. status is the
claimant operation when one exists, and invest otherwise.Authorizations
Query Parameters
The symbol of the token.
The unique identifier (UUID) of the STO.
Response
200 - application/json
Successful response - Investments for the specified STO retrieved.
Contains a list of offering transactions and the total count.