API · logowright

Send a logo, get a clean SVG back. Create an API key on your account page. A conversion costs one credit only when it succeeds.

1. Start a conversion

curl -X POST https://logowright.com/v1/vectorize \
  -H "Authorization: Bearer $LOGOWRIGHT_KEY" \
  -F file=@logo.png

Or pass a public link instead of a file: -F image_url=https://…/logo.png. Optional -F webhook_url=https://… receives the finished job once. The answer is 202 with a job_id.

2. Wait for it

curl https://logowright.com/v1/jobs/JOB_ID -H "Authorization: Bearer $LOGOWRIGHT_KEY"

Poll every 2 seconds until state is done. Most logos take 10 to 60 seconds; large images up to a few minutes. While it is queued or running, progress has a percent (0 to 100) and a short status line you can show to people as they wait.

status	meaning	charged
`ok`	Done. Download from `urls`.	1 credit
`refused`	Not a supported image; `reason.message` says what to send instead.	no
`quality_failed`	A result exists but did not pass our quality check.	no
`timeout`	Took longer than our limit.	no
`failed`	Our error.	no
`cancelled`	You cancelled it.	no

3. Download

curl -o logo.svg https://logowright.com/v1/jobs/JOB_ID/files/logo.svg

logo.svg is one clean SVG; logo-layers.svg keeps each shape as its own layer; bundle.zip has both. Converting the same image again from the same account is free. GET /v1/jobs/JOB_ID/source gives back the image you sent; images and results are kept for 30 days, then deleted.

Errors

Errors are JSON: {"error": "no_credits", "message": "…"}. 401 bad or missing key · 402 no credits left · 413 image too large · 415 not a PNG/JPEG · 429 too many at once (max 3 running per account).

Machine-readable schema: /v1/openapi.json.