---
title: "List Tally internal email recipients"
method: GET
path: "/tally/email-recipients"
tags: ["Tally"]
---

# List Tally internal email recipients

`GET /tally/email-recipients`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/tally/email-recipients`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns the narrow active firm directory for internal Tally email handoff. Only firm_staff memberships with valid emails are included. Each row has firmStaffId, name, email, and role. Pending invitations, company assignments, and management metadata are omitted.

## Query parameters

- `recipientType` 'firm', required

## Response `200`

Active firm recipients

- object
  - `recipients` object[], required
    - `firmStaffId` string, uuid, required
    - `name` string, nullable
    - `email` string, email, required
    - `role` string, required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)