LEleadfeeder
Account
v1

List Accounts

Changed on

Retrieves a list of Leadfeeder accounts associated with this API key. Without account_id, all accounts are listed with their names only. With account_id, only that account is returned, including its credit details.

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

get/v1/accounts

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/accounts
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: accounts:read

Query parameters

account_idstring

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

include'account_company'

Specify which additional data should be attached to the result. When account_company is included, the company attributes are inlined in the relationships.account_company field. Otherwise only id and type are returned.

Response

Success

OR

Example response

{
  "data": [
    {
      "attributes": {
        "credits": {
          "available": 10000,
          "credits_pools": [
            {
              "available": 50,
              "pool_type": "recurring",
              "remaining": 48,
              "renews_at": "2027-06-17",
              "used": 2
            }
          ],
          "next_reset_on": "2026-10-01",
          "remaining": 9480,
          "used": 520
        },
        "name": "Dealfront Group GmbH"
      },
      "id": "36744212",
      "relationships": {
        "account_company": {
          "id": "555001"
        }
      },
      "type": "account"
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • 775113fc1347Revision changes
    • info

      added the required property ///// to the response with the status

  • ac752c6c2be0Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status