List brand profiles

GET/v1/brand_profiles

Lists your brand profiles: the look of your notices and recipient pages.

Query parameters

limitinteger

Default 25
cursorstring

Returns

200 application/json. Paginated list.

Errors have one shape; see Errors for every code.

Code language

Request

curl "https://api.parasend.com/v1/brand_profiles" \
  -H "Authorization: Bearer $PARASEND_KEY"

const res = await fetch('https://api.parasend.com/v1/brand_profiles', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.parasend.com/v1/brand_profiles",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.parasend.com/v1/brand_profiles");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/brand_profiles"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .GET()
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.parasend.com/v1/brand_profiles', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

{
  "data": [
    {
      "id": "bp_01M6R27T817SW9MENZEV3KSZZX",
      "object": "brand_profile",
      "name": "Fyrirtæki ehf.",
      "is_default": false,
      "version": 1,
      "version_id": "bpv_01M6R27T82QZMJ98K4RGVQBRF0",
      "sender_display_name": "Fyrirtæki ehf.",
      "sender_display_name_dative": null,
      "logo": {
        "asset_id": "bas_01M6R27T7R9RDBHE6X72ZRW3YC",
        "url": "/v1/brand_assets/bas_01M6R27T7R9RDBHE6X72ZRW3YC/content",
        "sha256": "f72bdd36e6ce104c53c8f21bd9e618e113a66f4d6729d43a4cb07b3f1373addb",
        "width": 200,
        "height": 48
      },
      "monogram": "F",
      "sms_sender_name": null,
      "icon": null,
      "primary_color": "#1E5BB8",
      "contrast_ratio": 6.47,
      "header_style": "band",
      "support": {
        "email": null,
        "phone": null,
        "url": null
      },
      "expired_message": {
        "is": null,
        "en": null
      },
      "reply_to": null,
      "recipient_domain_id": null,
      "email_sender_id": null,
      "theme": {
        "colors": {
          "page_background": null,
          "card_background": null,
          "text": null,
          "secondary_text": null,
          "button_background": null,
          "button_text": null,
          "header_background": null,
          "header_text": null,
          "divider": null
        },
        "button_radius": null,
        "card_radius": null,
        "card_shadow": null,
        "font": null,
        "logo_height": null,
        "header_align": null,
        "show_safety_note": null,
        "show_support_line": null,
        "show_sender_line": null,
        "card_footer": null,
        "card_footer_text": {
          "is": null,
          "en": null
        },
        "layout": null,
        "page_image_asset_id": null,
        "logo_background": "tile",
        "show_name_with_logo": null,
        "show_service_label": null
      },
      "contrasts": {
        "text_on_card": 18.19,
        "links_on_card": 6.47,
        "header_text_on_header": 6.47,
        "button_text_on_primary": 6.47,
        "secondary_text_on_card": 5.98
      },
      "used_by": {
        "deliveries": 0
      },
      "created_at": "2026-11-06T09:15:05.856Z",
      "updated_at": "2026-11-06T09:15:05.856Z",
      "archived_at": null
    }
  ],
  "has_more": false,
  "next_cursor": null
}