Bundles

Get bundle status

Poll the aggregate status of a bundle. Check each file's status field: queued → analyzing → complete | failed. The response includes poll_interval_seconds; wait at least that many seconds before polling again.

get/v1/bundles/{bundle_id}

Request

  • Base URL: https://api.blee.com
  • URL: https://api.blee.com/v1/bundles/{bundle_id}
  • Auth: HTTP bearer

Path parameters

bundle_idstring required

The bundle_id returned by POST /v1/bundles.

Response

Bundle status.

bundle_idstring required
namestring nullable required

Placeholder field. Bundle names are not persisted, so this is always null on status reads.

external_refstring nullable required

Partner-supplied bundle reference set once at creation (e.g. an MRF Record ID). Stable across polls and PATCHes; null when the bundle was created without one.

status'analyzing' | 'failed' | 'pending_review' | 'approved' | 'not_approved' | 'partial' required

Aggregate bundle lifecycle rolled up from per-asset status values. Precedence (first match wins): any in-flight asset → analyzing; any not_approved → not_approved (rejection wins); AI-mixed (some failed, some non-failed terminal) → partial; all failed → failed; any pending_review → pending_review; all approved → approved.

dashboard_urlstring required
created_atstring required
completed_atstring nullable required
poll_interval_secondsinteger required

Recommended number of seconds to wait before polling again. Respect this interval; do not poll more frequently.

Example response

{
  "files": [
    {
      "result": {
        "summary": "Asset approved.",
        "analysis_completed_at": "2026-05-18T23:00:00Z"
      },
      "reviewers": [
        {
          "name": "Jane Reviewer",
          "review_status": "APPROVED",
          "review_status_label": "Approved with conditions",
          "review_status_reason": "Looks good once disclaimer is fixed.",
          "review_status_updated_at": "2026-05-19T15:42:00Z"
        }
      ],
      "comments": [
        {
          "created_at": "2026-05-19T15:30:00Z",
          "created_by_name": "Jane Reviewer"
        }
      ]
    }
  ],
  "urls": [
    {
      "result": {
        "summary": "Asset approved.",
        "analysis_completed_at": "2026-05-18T23:00:00Z"
      },
      "reviewers": [
        {
          "name": "Jane Reviewer",
          "review_status": "APPROVED",
          "review_status_label": "Approved with conditions",
          "review_status_reason": "Looks good once disclaimer is fixed.",
          "review_status_updated_at": "2026-05-19T15:42:00Z"
        }
      ],
      "comments": [
        {
          "created_at": "2026-05-19T15:30:00Z",
          "created_by_name": "Jane Reviewer"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.