> ## Documentation Index
> Fetch the complete documentation index at: https://docs.photon.codes/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Fetching iMessage attachments
> Retrieve cloud iMessage attachments directly by GUID.
export const TypeTooltip = ({name, type, children}) => {
const [visible, setVisible] = React.useState(false);
const [pos, setPos] = React.useState({
top: 0,
left: 0
});
const triggerRef = React.useRef(null);
const show = () => {
if (triggerRef.current) {
const rect = triggerRef.current.getBoundingClientRect();
setPos({
top: rect.bottom + 6,
left: rect.left
});
}
setVisible(true);
};
const hide = () => setVisible(false);
return <>
{children || {name}}
{visible &&
{type}
}
;
};
Retrieve an attachment by its iMessage GUID using `getAttachment` on the
narrowed platform instance. The returned
;`} /> is
lazy. `.read()` and `.stream()` each trigger an independent download, so cache
`.read()` if you need the bytes more than once.
```ts theme={null}
import { imessage } from "spectrum-ts/providers/imessage";
const im = imessage(app);
const att = await im.getAttachment("p:0/GUID");
if (att) {
console.log(att.name, att.mimeType, att.size);
const bytes = await att.read();
}
```
In multi-phone mode, pass the phone number as the second argument to route the
request through the correct instance:
```ts theme={null}
const att = await im.getAttachment("p:0/GUID", "+15559999999");
```
When only one phone is configured, or in shared-pool mode, the phone parameter
is optional.
`getAttachment` requires `@spectrum-ts/imessage`. With
`@spectrum-ts/imessage-local`, it throws an
.
Local inbound attachments are still available through each incoming
message's content.