---
title: "POST /v1/licenses/execute — Finalize a quote into a license lifecycle tied to a payment intent."
method: POST
path: "/v1/licenses/execute"
tags: ["Licenses"]
---

# POST /v1/licenses/execute — Finalize a quote into a license lifecycle tied to a payment intent.

`POST /v1/licenses/execute`

## Request

- Base URL: `https://api.stockfilm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stockfilm.com/v1/licenses/execute`
- Auth: API key in header `Authorization`

Validates that the quote and payment intent exist, belong to the calling
tenant, and are linked. Returns the current license state and a next-action
hint indicating what the client should do. Does NOT activate unpaid licenses.

## Request body

- ExecuteLicenseRequest: Request body for POST /v1/licenses/execute.
  - `payment_intent_id` string, uuid, required: The payment intent that should cover this license.
  - `quote_id` string, uuid, required: The quote this license is tied to.

## Response `200`

License execution result with next-action hint

- ExecuteLicenseResponse: Response body for POST /v1/licenses/execute.
  - `activated_at` string, date-time, nullable
  - `asset_id` string, uuid, required
  - `created_at` string, date-time, required
  - `delivery_file` DeliveryFileInfo
    - `clip_id` string, nullable: Optional upstream clip identifier.
    - `filename` string, required: Filename to return to the agent when file delivery is staged.
    - `mode` string, required: Delivery mode for this fulfillment payload.
  - `license_id` string, uuid, required
  - `next_action` string, nullable
  - `payment_intent_id` string, uuid, required
  - `quote_id` string, uuid, required
  - `status` string, required
  - `term_end` string, date, nullable
  - `term_start` string, date, nullable
  - `territory` string, required
  - `updated_at` string, date-time, required
  - `usage_scope` string, required

## Other responses

- `400`: Mismatched references
- `404`: Quote, payment intent, or license not found

---

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