v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Buyer Personas
v1

Retrieve Buyer Personas

Retrieve all buyer personas defined in the account. Each buyer persona is a saved set of contact-level filter criteria (department, job title, location, seniority) used to identify target contacts.

Credit Note: Retrieving buyer persona definitions does not consume credits.

:::info Requires the buyer_personas:read OAuth2 scope. :::

get/v1/buyer-personas

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

Response

Success

Example response

{
  "data": [
    {
      "type": "buyer_persona",
      "id": "7421",
      "attributes": {
        "name": "Sales Managers",
        "created_at": "2024-12-10T15:57:25Z",
        "filters": {
          "department": [
            {
              "search_value": "US",
              "display_value": "United States"
            }
          ],
          "job_title": [
            {
              "search_value": "US",
              "display_value": "United States"
            }
          ],
          "location": [
            {
              "search_value": "US",
              "display_value": "United States"
            }
          ],
          "seniority": [
            {
              "search_value": "US",
              "display_value": "United States"
            }
          ]
        }
      }
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}