GetAssets API
The GetAssets API allows developers to get assets (domains) from the platform. You can get all the assets in a single request using this API.
There are two sections on the Assets page of the Platform where assets are visible:
- Managed by Brand
- Managed by Affiliates
The section where the assets are fetched is determined by the “isAffiliated” flag in the API. You can also view all the assets via the Platform’s Assets page.
Step 1: Locate Your API Key
Before using the GetAssets API, you need your Bolster API Key. Follow these steps to find it:
- Click on the user dropdown in the top-right corner of the page.
- Select Profile Information from the dropdown menu.
- Copy the API key displayed on your profile screen.
Step 2: Initiate request through API
To make a GetAssets request, use the following details.
Endpoint:
/api/neo/v1/getAssets
API Host:
https://developers.bolster.ai
Request Format:
curl --location --request POST 'https://developers.bolster.ai/api/neo/v1/getAssets' \
--header 'Content-Type: application/json' \
--data '{
"apiKey": "<your_api_key>",
"isAffiliated": false
}'
Request Parameters
- apiKey (required): Your user API key.
- isAffiliated (optional): Default is false. Set this to false (or omit it) to get assets from “Managed by Brand”. Set to true to get assets from “Managed by Affiliates”.
Response
Upon a successful request, you will receive a response like the following with a Status code: 200.
[
{
"assetHash": "d4c9d9027326271a89ce51fcaf328ed673f17be33469ff979e8ab8dd501e664f",
"assetName": "google.com",
"ipAddress": "142.250.191.78",
"country": "UNITED STATES",
"createdTs": "2023-10-20T23:51:35.652Z",
"registrar": "MarkMonitor Inc.",
"isAffiliated": false,
"brandName": "Bolster"
},
{
"assetHash": "31193328f8e21dfb6c99f322d22d7b0b508778e64ffbba86e52293379031b874",
"assetName": "facebook.com",
"ipAddress": "57.144.220.1",
"country": "UNITED STATES",
"createdTs": "2025-08-07T18:40:55.374Z",
"registrar": "RegistrarSafe, LLC",
"isAffiliated": false,
"brandName": "Bolster"
}
]If there are no assets present, the response array will be empty:
[]
If you are unauthorized to access the API or for some other unauthorized reason:
{
"error": {
"statusCode": 401,
"message": "Not authorized."
}
}In case of an unsuccessful request, the following status codes and error messages may be returned:
- Status Code: 500. Message: Invalid API key or API key not enabled.
- Status Code: 401. Message: Not authorized.
Support
If you have any questions or encounter any issues while using the GetAssets API, please contact our support team at support@bolster.ai.
