Disable a License

Endpoint

PUT https://api.gumroad.com/v2/licenses/disable

Disables a license key, preventing it from being verified. When disabled, any attempt to verify the license will return an error indicating that it has been disabled. This does not delete the license - it can be re-enabled later using the enable endpoint.

This endpoint requires authentication with the edit_products scope.

Authentication

This endpoint requires an OAuth access token with the edit_products scope. Include your access token in the request:

?access_token=YOUR_ACCESS_TOKEN

Request Parameters

string

required

Your OAuth access token with edit_products scope

string

required

The license key to disable

string

The unique identifier for your product (recommended)

string

The product’s permalink (either unique or custom). Can be used instead of product_id.

Response Fields

boolean

Whether the operation was successful

integer

The current usage count for this license

object

Complete purchase information associated with this license (same structure as the verify endpoint)

Examples

Disable a license

curl -X PUT https://api.gumroad.com/v2/licenses/disable \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  -d "product_id=your-product-id" \
  -d "license_key=ABCD1234-EFGH5678-IJKL9012-MNOP3456"

import requests

response = requests.put(
    'https://api.gumroad.com/v2/licenses/disable',
    data={
        'access_token': 'YOUR_ACCESS_TOKEN',
        'product_id': 'your-product-id',
        'license_key': 'ABCD1234-EFGH5678-IJKL9012-MNOP3456'
    }
)

print(response.json())

const response = await fetch('https://api.gumroad.com/v2/licenses/disable', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: new URLSearchParams({
    access_token: 'YOUR_ACCESS_TOKEN',
    product_id: 'your-product-id',
    license_key: 'ABCD1234-EFGH5678-IJKL9012-MNOP3456'
  })
});

const data = await response.json();
console.log(data);

Success Response

{
  "success": true,
  "uses": 5,
  "purchase": {
    "id": "encrypted_purchase_id",
    "product_name": "My Software",
    "product_id": "encrypted_product_id",
    "product_permalink": "https://gumroad.com/l/my-software",
    "short_product_id": "my-software",
    "email": "customer@example.com",
    "price": 2999,
    "currency": "usd",
    "quantity": 1,
    "created_at": "2024-01-15T10:30:00Z",
    "sale_timestamp": "2024-01-15T10:30:00Z",
    "order_number": 123456,
    "license_key": "ABCD1234-EFGH5678-IJKL9012-MNOP3456",
    "variants": "",
    "custom_fields": [],
    "refunded": false,
    "chargebacked": false,
    "subscription_ended_at": null,
    "subscription_cancelled_at": null,
    "subscription_failed_at": null,
    "can_contact": true
  }
}

Error Responses

Unauthorized (401)

{
  "error": "The access token is invalid"
}

Forbidden (403)

Returned when the access token doesn’t have the edit_products scope.

{
  "error": "Forbidden"
}

Not Found (404)

Returned when the license doesn’t exist or doesn’t belong to your product.

{
  "success": false,
  "message": "That license does not exist for the provided product."
}

Common Use Cases

Revoke Access for Policy Violations

If a customer violates your terms of service or shares their license key publicly, you can disable their license to prevent unauthorized use.

Handle Chargebacks or Refunds

When a purchase is refunded or charged back, you may want to disable the associated license key to prevent continued access to your product.

Enforce License Limits

If you discover that a license is being used beyond its allowed scope (e.g., on too many devices), you can disable it until the customer contacts you.

Only the product owner can disable licenses for their products. You must authenticate with an access token from the product owner’s account.

Disabling a license does not delete it. The license can be re-enabled at any time using the enable endpoint.

Getting Started

Products

Sales

Licenses

Subscribers

Other Resources

Disable a License

Endpoint

Authentication

Request Parameters

Response Fields

Examples

Disable a license

Success Response

Error Responses

Unauthorized (401)

Forbidden (403)

Not Found (404)

Common Use Cases

Revoke Access for Policy Violations

Handle Chargebacks or Refunds

Enforce License Limits

​Endpoint

​Authentication

​Request Parameters

​Response Fields

​Examples

​Disable a license

​Success Response

​Error Responses

​Unauthorized (401)

​Forbidden (403)

​Not Found (404)

​Common Use Cases

​Revoke Access for Policy Violations

​Handle Chargebacks or Refunds

​Enforce License Limits

Endpoint

Authentication

Request Parameters

Response Fields

Examples

Disable a license

Success Response

Error Responses

Unauthorized (401)

Forbidden (403)

Not Found (404)

Common Use Cases

Revoke Access for Policy Violations

Handle Chargebacks or Refunds

Enforce License Limits