List profiles in organization

Retrieves all sender profiles within an organization, including brand information for each profile. Profiles represent different brands, departments, or use cases within an organization, each with their own messaging configuration.

GET
/v3/profiles

Header Parameters

x-profile-id?string

Profile UUID to scope the request to a child profile. Only organization API keys can use this header. The profile must belong to the calling organization.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://api.sent.dm/v3/profiles"
{
  "success": true,
  "data": {
    "profiles": [
      {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "organization_id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Marketing Team",
        "email": "team@acme.com",
        "icon": "https://example.com/marketing-icon.png",
        "description": "Marketing department sender profile",
        "short_name": "MKT",
        "status": "approved",
        "created_at": "2025-12-11T21:50:50.1574292+00:00",
        "updated_at": "2026-03-06T21:50:50.1574304+00:00",
        "allow_contact_sharing": true,
        "allow_template_sharing": false,
        "inherit_contacts": true,
        "inherit_templates": false,
        "inherit_tcr_brand": false,
        "inherit_tcr_campaign": false,
        "billing_model": "profile",
        "sending_phone_number_profile_id": null,
        "sending_whatsapp_number_profile_id": null,
        "sending_phone_number": null,
        "whatsapp_phone_number": null,
        "allow_number_change_during_onboarding": null,
        "waba_id": null,
        "billing_contact": null,
        "brand": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "tcr_brand_id": null,
          "status": null,
          "identity_status": null,
          "universal_ein": null,
          "csp_id": null,
          "submitted_to_tcr": false,
          "submitted_at": null,
          "is_inherited": false,
          "created_at": "2025-12-11T21:50:50.1574315+00:00",
          "updated_at": null,
          "contact": {
            "name": "John Smith",
            "business_name": "Acme Corp",
            "role": null,
            "phone": null,
            "email": "john@acmecorp.com",
            "phone_country_code": null
          },
          "business": {
            "legal_name": "Acme Corporation LLC",
            "tax_id": null,
            "tax_id_type": null,
            "entity_type": null,
            "street": null,
            "city": null,
            "state": null,
            "postal_code": null,
            "country": "US",
            "url": null,
            "country_of_registration": null
          },
          "compliance": {
            "vertical": "PROFESSIONAL",
            "brand_relationship": "SMALL_ACCOUNT",
            "primary_use_case": null,
            "expected_messaging_volume": null,
            "is_tcr_application": true,
            "phone_number_prefix": null,
            "destination_countries": [],
            "notes": null
          }
        }
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-11T21:50:50.1574972+00:00",
    "version": "v3"
  }
}
Empty
Empty
{
  "success": false,
  "data": null,
  "error": {
    "code": "RESOURCE_005",
    "message": "Organization not found",
    "details": null,
    "doc_url": "https://docs.sent.dm/errors/RESOURCE_005"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-11T21:50:50.157501+00:00",
    "version": "v3"
  }
}
{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_001",
    "message": "Failed to retrieve profiles. Please contact support with request ID: req_7X9zKp2jDw",
    "details": null,
    "doc_url": "https://docs.sent.dm/errors/INTERNAL_001"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-11T21:50:50.1575017+00:00",
    "version": "v3"
  }
}