---
title: "Who is behind a matter: the organisation, the people involved, the history"
method: GET
path: "/api/assistant/work-items/{id}/sender"
tags: ["Mailzero Assistant"]
---

# Who is behind a matter: the organisation, the people involved, the history

`GET /api/assistant/work-items/{id}/sender`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/assistant/work-items/{id}/sender`
- Auth: HTTP bearer

Answers the sender card of a matter: the sender's organisation as the stored domain profile knows it (name, legal name, category, website, registration date, mail posture; null for a shared mail domain such as gmail.com or a domain never analysed, and never a live analysis), the people the story's messages carry in from, to and cc with their roles and whether they belong to the same organisation (the reader's own mailboxes left out), and the relationship: how much mail came from this address across the reader's mailboxes (counted up to 50), when first and last, the sender's other matters and the matters raised by colleagues at the same domain. Requires the assistant:read scope.

## Path parameters

- `id` string, required

## Response `200`

The sender card

- AssistantSenderCard: Who is behind a matter (IN-01): the organisation from the stored domain profile, the people of the story, and what already passed with the sender.
  - `work_item_id` string
  - `sender` object, nullable
    - `address` string
    - `name` string, nullable
    - `kind` string
    - `domain` string, nullable
    - `shared_domain` boolean: A shared mail domain (gmail.com, outlook.com) names no organisation.
  - `organisation` object, nullable: Null for a shared mail domain or a domain never analysed.
    - `domain` string
    - `name` string, nullable
    - `legal_name` string, nullable
    - `pitch` string, nullable
    - `category` string, nullable
    - `language` string, nullable
    - `website` object
      - `title` string, nullable
      - `url` string, nullable
    - `registered_at` string, date-time, nullable
    - `registrar` string, nullable
    - `mail` object
      - `status` string
      - `provider` string, nullable
      - `spf` boolean, nullable
      - `dmarc` string
    - `analysed_at` string, date-time
    - `fresh` boolean
  - `participants` object[]
    - `address` string
    - `name` string, nullable
    - `roles` string[]
    - `messages` integer
    - `same_organisation` boolean
  - `relationship` object
    - `received` integer: Mail received from this address across the reader's mailboxes, counted up to 50.
    - `received_capped` boolean
    - `first_received_at` string, date-time, nullable
    - `last_received_at` string, date-time, nullable
    - `open_matters` integer
    - `matters` AssistantSenderMatter[]
      - `id` string
      - `title` string
      - `status` string
      - `attention_level` string
      - `last_seen_at` string, date-time
    - `organisation` object, nullable
      - `other_senders` string[]
      - `matters` AssistantSenderMatter[]
        - `id` string
        - `title` string
        - `status` string
        - `attention_level` string
        - `last_seen_at` string, date-time
  - `generated_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `404`: Work item not found
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)