---
title: "Get IP Asset Licenses"
method: GET
path: "/v1/ip/licenses/{ipassetId}"
tags: ["IP Story Protocol"]
---

# Get IP Asset Licenses

`GET /v1/ip/licenses/{ipassetId}`

## Request

- Base URL: `https://staging.crossmint.com/api`
- URL: `https://staging.crossmint.com/api/v1/ip/licenses/{ipassetId}`
- Auth: none required
- TypeScript: <https://skmtc.dev/crossmint/apis/onramp/docs/v1/ip/licenses/:ipassetId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the licenses of an IP Asset

The ipassetId parameter should be the Story Protocol asset ID (not the Crossmint ID). Must start with '0x' followed by hexadecimal characters.

**API scope required**: `nfts.read`

## Path parameters

- `ipassetId` string, required

## Headers

- `X-API-KEY` string, required

## Response `200`

IP Asset License found

- object[]: Specific terms for a Story Protocol PIL (Programmable IP License). Default is the `Non-Commercial Social Remixing` license. More details here: https://docs.story.foundation/docs/pil-terms
  - `id` string, required: The License Terms ID
  - `terms` object, required: The PIL terms details as per retrieved from story
    - `transferable` boolean, required: If false, the License Token cannot be transferred once it is minted to a recipient address
    - `royaltyPolicy` string, required: The address of the royalty policy contract
    - `defaultMintingFee` number, required: The fee to be paid when minting a license
    - `expiration` number, required: The expiration period of the license
    - `commercialUse` boolean, required: Determines if the licensee can make money from using the original IP Asset
    - `commercialAttribution` boolean, required: If true, people must give credit to the original work in their commercial application
    - `commercializerChecker` string, required: Commercializers that are allowed to commercially exploit the original work. If zero address, then no restrictions are enforced.
    - `commercializerCheckerData` string, required: The data to be passed to the commercializer checker contract.
    - `commercialRevShare` number, required: Amount of revenue (from any source, original & derivative) that must be shared with the licensor (a value of 10,000,000 == 10% of revenue share).
    - `commercialRevCeiling` number, required: Maximum revenue that can be earned from the original work if commercialUse is true
    - `derivativesAllowed` boolean, required: Indicates whether the licensee can create derivatives of the work
    - `derivativesAttribution` boolean, required: If true, derivatives must give credit to the original work
    - `derivativesApproval` boolean, required: If true, the licensor must approve derivatives of the work
    - `derivativesReciprocal` boolean, required: If true, derivatives must have the exact same terms
    - `derivativeRevCeiling` number, required: Maximum revenue that can be earned from derivative works if commercialUse is true
    - `currency` string, required: The ERC20 token address to be used to pay the minting fee
    - `uri` string, required: URI containing additional license terms, will be overridden by the license terms in the metadata
  - `disabled` boolean: If true, the license terms will be disabled. Effectively preventing future mints with this license.

---

[API](https://skmtc.dev/crossmint/apis/onramp.md) - [All operations](https://skmtc.dev/crossmint/apis/onramp/llms.txt) - [OpenAPI document](https://skmtc.dev/crossmint/apis/onramp/revisions/e2143d192130?raw)