---
title: "Badge Resolve"
method: GET
path: "/v1/badge/resolve"
---

# Badge Resolve

`GET /v1/badge/resolve`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/badge/resolve`
- Auth: none declared

Resolve an arbitrary article URL to its Storyflo audio. Used by the
newsletter embed badge — newsletter authors drop a one-line `<a>` or
`<iframe>` linking to ``/embed/badge?u=<url>`` and Storyflo handles
the rest:

  - if we already rendered audio for that URL, return it immediately
  - if not, queue a render-on-demand (priority lane) and return
    ``status='rendering'`` so the badge can poll until ready
  - tag every produced article with ``origin='subscribed'`` and
    ``sender_email=<host>`` so per-publisher rev-share accrues from
    the first listen, no claim flow required up front

## Query parameters

- `u` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)