cURL
curl https://api.bodhveda.com/preferences \
-H "Authorization: Bearer bv_xxxxxxxxx"import { Bodhveda } from "@bodhveda/js";
const bodhveda = new Bodhveda("bv_xxxxxxxxx");
const preferences = await bodhveda.preferences.list();import (
"context"
bodhveda "github.com/MudgalLabs/bodhveda/sdk/go"
)
ctx := context.Background()
client := bodhveda.NewClient("bv_xxxxxxxxx", nil)
preferences, _ := client.Preferences.List(ctx){
"data": [
{
"id": 12,
"project_id": 1,
"target": {
"channel": "digest",
"topic": "none",
"event": "sent"
},
"medium": "email",
"default_enabled": true,
"label": "Daily digest",
"created_at": "2025-11-07T05:31:56Z",
"updated_at": "2025-11-07T05:31:56Z"
}
]
}Project Preferences
List the catalog
List every entry in the project’s preference catalog. The project is taken from the API key. Requires a Full access key.
GET
/
preferences
cURL
curl https://api.bodhveda.com/preferences \
-H "Authorization: Bearer bv_xxxxxxxxx"import { Bodhveda } from "@bodhveda/js";
const bodhveda = new Bodhveda("bv_xxxxxxxxx");
const preferences = await bodhveda.preferences.list();import (
"context"
bodhveda "github.com/MudgalLabs/bodhveda/sdk/go"
)
ctx := context.Background()
client := bodhveda.NewClient("bv_xxxxxxxxx", nil)
preferences, _ := client.Preferences.List(ctx){
"data": [
{
"id": 12,
"project_id": 1,
"target": {
"channel": "digest",
"topic": "none",
"event": "sent"
},
"medium": "email",
"default_enabled": true,
"label": "Daily digest",
"created_at": "2025-11-07T05:31:56Z",
"updated_at": "2025-11-07T05:31:56Z"
}
]
}List every entry in your project’s preference catalog — the project-level rules that declare which
(target, medium) pairs your project may send and the default a recipient inherits. The project is taken from the API key.
This is distinct from a recipient’s own preferences. To manage the catalog from the dashboard instead, go to Bodhveda Console > Preferences.Authorizations
Bearer authentication header of the form Bearer bv_xxxxxxxxx, where bv_xxxxxxxxx is your API Key with Full access scope.
Response
200 - application/json
The project's catalog.