---
title: "Share metadata including safety-check status"
method: GET
path: "/files/share/{shortId}"
tags: ["Files"]
---

# Share metadata including safety-check status

`GET /files/share/{shortId}`

## Request

- Base URL: `https://api.beecargo.net`
- URL: `https://api.beecargo.net/files/share/{shortId}`
- Auth: none declared

Public share metadata. Poll scanStatus until clean before machine download. Share link works immediately; downloads wait for the safety check.

## Path parameters

- `shortId` string, required

## Response `200`

Share metadata

- ShareMetaResponse
  - `id` string: fileId
  - `short_id` string
  - `name` string
  - `size_bytes` integer
  - `expires_at` string, date-time, nullable
  - `scanStatus` 'pending' | 'scanning' | 'clean' | 'unavailable': Safety check status. Download only when clean.
  - `unlockRequired` boolean: True when an unlock code or delivery link is required
  - `content_type` string, nullable
  - `directEffective` boolean
  - `sponsoredDelivery` boolean

## Other responses

- `404`: Share not found or expired

---

[API](https://skmtc.dev/beecargo/apis/beecargo-agent-api.md) · [All operations](https://skmtc.dev/beecargo/apis/beecargo-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beecargo/apis/beecargo-agent-api/revisions/1f3dfd396f6e?raw)