ChronicleSchema
Used on
Message, CallSession, FinancialTransaction and their subclasses
Expected type
Agent
Values
A list of values
Required
No

In other vocabularies

VocabularyTermHow they differ
schema.org Same as recipient
Activity Streams 2.0 Close to to Activity Streams separates the primary audience, as:to, from copies in as:cc, as:bto, and as:bcc.

Examples

Receiving a message with a photo

A MessageAction for a message Alex sent you.

{
  "@type": "MessageAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "imessage",
  "timestamp": "2026-05-09T18:22:07.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "icloud",
    "handle": "alex@example.com",
    "name": "Alex Chen",
    "sameAs": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "email",
        "handle": "alex@example.com"
      }
    ]
  },
  "result": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "imessage",
    "sourceId": "9B1C5E2A-7F43-4D8E-A6B0-3C2F9E14D7A5",
    "body": "Found the trailhead!",
    "recipient": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "handle"],
        "source": "phone",
        "handle": "+15555550123",
        "sameAs": ["@me"]
      }
    ],
    "contains": [
      {
        "@type": "ImageObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "E4A7C2D9-1B6F-4F3A-8C5E-7D2B9A0F6E13",
        "contentPath": "/Users/sam/Library/Messages/Attachments/4f/15/trailhead.jpg",
        "mimeType": "image/jpeg",
        "description": "trailhead.jpg"
      }
    ]
  }
}

Sharing a video and a PDF with a group

A message to a group has one recipient per person.

{
  "@type": "MessageAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "imessage",
  "timestamp": "2026-06-21T14:10:02.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle"],
    "source": "phone",
    "handle": "+15555550123",
    "sameAs": ["@me"]
  },
  "result": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "imessage",
    "sourceId": "C7A3E1F5-2D8B-4C6A-9E0F-4B7D2A5C8E31",
    "body": "Video from the summit, and the permit for Saturday.",
    "recipient": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "icloud",
        "handle": "alex@example.com",
        "name": "Alex Chen"
      },
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "phone",
        "handle": "+15555550188",
        "name": "Jordan Lee"
      }
    ],
    "isPartOf": [
      {
        "@type": "Channel",
        "@key": ["@type", "source", "sourceId"],
        "source": "imessage",
        "sourceId": "5E2B9C14-8A3F-4D71-B6E0-9F4C2A7D1E58",
        "name": "Summit crew",
        "member": [
          {
            "@type": "Agent",
            "@key": ["@type", "source", "handle"],
            "source": "icloud",
            "handle": "alex@example.com"
          },
          {
            "@type": "Agent",
            "@key": ["@type", "source", "handle"],
            "source": "phone",
            "handle": "+15555550188"
          }
        ]
      }
    ],
    "contains": [
      {
        "@type": "VideoObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "D1F6B3A8-4E2C-4A9D-B5E7-8C0A2F4D6B19",
        "contentPath": "/Users/sam/Library/Messages/Attachments/7c/12/summit.mov",
        "mimeType": "video/quicktime",
        "description": "summit.mov"
      },
      {
        "@type": "DocumentObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "F8C2A5D7-9B1E-4F6C-A3D0-2E5B8C1F4A76",
        "contentPath": "/Users/sam/Library/Messages/Attachments/7c/13/permit.pdf",
        "mimeType": "application/pdf",
        "description": "permit.pdf"
      }
    ]
  }
}

A card purchase

You bought a coffee with a credit card, and within minutes the card's issuer told Wallet about it.

{
  "@type": "PayAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "apple-wallet",
  "timestamp": "2026-05-09T13:41:07.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "sourceId"],
    "source": "icloud",
    "sourceId": "1234567890",
    "handle": "sam@example.com",
    "sameAs": ["@me"]
  },
  "instrument": [
    {
      "@type": "PaymentCard",
      "@key": ["@type", "source", "sourceId"],
      "source": "apple-wallet",
      "sourceId": "V-0000000000000000000001",
      "name": "Example Rewards Visa",
      "alternateName": ["4242"],
      "category": ["credit"],
      "inAccount": [
        {
          "@type": "FinancialAccount",
          "@key": ["@type", "source", "sourceId"],
          "source": "apple-wallet",
          "sourceId": "8d2f0c4a1b7e9f3c5a6d4e2b1c9f8a7d6e5b4c3a2f1e0d9c8b7a6f5e4d3c2b1a",
          "name": "Example Bank",
          "financialAccountType": "liability"
        }
      ]
    }
  ],
  "result": {
    "@type": "FinancialTransaction",
    "@key": ["@type", "source", "sourceId"],
    "source": "apple-wallet",
    "sourceId": "7C1E9F2B-6A3D-4B58-9E0F-2D4C6B8A1E35",
    "amount": {
      "@type": "MonetaryAmount",
      "value": 4.75,
      "currency": "CAD"
    },
    "recipient": [
      {
        "@type": "Agent",
        "@key": ["source", "name"],
        "source": "apple-wallet",
        "name": "Example Café"
      }
    ],
    "hasPart": [
      {
        "@type": "FinancialPosting",
        "@key": ["@type", "source", "action.result.sourceId", "inAccount[*].sourceId"],
        "source": "apple-wallet",
        "amount": {
          "@type": "MonetaryAmount",
          "value": -4.75,
          "currency": "CAD"
        },
        "inAccount": [
          {
            "@type": "FinancialAccount",
            "@key": ["@type", "source", "sourceId"],
            "source": "apple-wallet",
            "sourceId": "8d2f0c4a1b7e9f3c5a6d4e2b1c9f8a7d6e5b4c3a2f1e0d9c8b7a6f5e4d3c2b1a"
          }
        ]
      }
    ]
  }
}

URI https://schema.chronicle.app/recipient · Suggest a change

Esc

↑↓ to move↵ to open/ or ⌘K to search