---
title: "List Accounts"
method: GET
path: "/v1/accounts"
tags: ["Account", "v1"]
---

# List Accounts

`GET /v1/accounts`

Retrieves a list of Leadfeeder accounts associated with this API key. When listing all accounts, only the account names are returned. Detailed credit information is accessible only when querying a specific account.

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

## Query parameters

- `account_id` string
- `include` 'account_company'

## Response `200`

Success

- union — If `account_id` is supplied, the response includes one account with credit details; if omitted, the response is an array of accounts without credit information.
  - object
    - `data` AccountV1[], required
      - `type` 'account', required — The type of the object
      - `id` string, required — The account ID.
      - `attributes` object, required
        - `name` string, required — The account name.
        - `credits` object, required
          - `available` number, required — The credits included in the subscription.
          - `used` number, required — How many credits were consumed up to now in the account.
          - `remaining` number, required — How many credits are remaining in the account.
          - `next_reset_on` string, date, required — The date when the credits will be reset.
      - `relationships` object, required
        - `account_company` union — The company the account belongs to. Present for every account that belongs to a company, and omitted for the rare account that is not attached to one. By default this field only contains the `id` and `type` fields, but you can load the company attributes by passing the `include=account_company` url parameter.
          - object — A bare reference to the company an account belongs to.
            - `id` string, required — The company ID.
            - `type` 'account_company', required
          - AccountCompanyV1
            - `type` 'account_company', required — The type of the object
            - `id` string, required — The company ID.
            - `attributes` object, required
              - …
    - `meta` object, required
      - `request_id` string, required — A unique identifier assigned to each API request for end-to-end traceability.
  - object
    - `data` AccountSummaryV1[], required
      - `type` 'account_summary', required — The type of the object
      - `id` string, required — The account ID.
      - `attributes` object, required
        - `name` string, required — The account name.
      - `relationships` object, required
        - `account_company` union — The company the account belongs to. Present for every account that belongs to a company, and omitted for the rare account that is not attached to one. By default this field only contains the `id` and `type` fields, but you can load the company attributes by passing the `include=account_company` url parameter.
          - object — A bare reference to the company an account belongs to.
            - `id` string, required — The company ID.
            - `type` 'account_company', required
          - AccountCompanyV1
            - `type` 'account_company', required — The type of the object
            - `id` string, required — The company ID.
            - `attributes` object, required
              - …
    - `meta` object, required
      - `request_id` string, required — A unique identifier assigned to each API request for end-to-end traceability.

## Other responses

- `401` — Unauthorized. The request was rejected because the credentials are missing, invalid, expired, or have been revoked. The client must re-authenticate before retrying. Clients can differentiate via the `code` value of the first item in `errors`.
- `403` — Forbidden. The credentials are valid but the caller is not authorized to perform the request — typically because the user lacks the required permission, the OAuth scope is insufficient, the subscription plan does not include the required entitlement, the `account_id` does not belong to the authenticated user, or the target list is read-only and its members cannot be modified. Clients can differentiate via the `code` value of the first item in `errors`.
- `429` — Too many requests. Either the per-second rate limit or the monthly quota configured for the API key / OAuth application has been exceeded. Clients can differentiate via the `code` value of the first item in `errors`.
- `500` — Internal server error
- `504` — Server timeout

---

[API](https://skmtc.net/leadfeeder/apis/leadfeeder-public-api.md) · [All operations](https://skmtc.net/leadfeeder/apis/leadfeeder-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadfeeder/leadfeeder-public-api/revisions/9e2e63ba2a4e/schema)