# Unlockpdf Skill

> UnlockPDF Skill

- Skill: `toolsforai/unlockpdf-skill` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add toolsforai/unlockpdf-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/toolsforai/unlockpdf-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ToolsforAI (https://skillmd.com/u/toolsforai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/toolsforai/unlockpdf-skill

---

# UnlockPDF Skill

Use this skill to remove password protection from PDF files using UnlockPDF.dev.

## What you can do

- Remove password from a PDF when the user knows the password
- Remove copy/print/edit restrictions from PDFs (no password needed)
- Check how many free unlocks remain today

## How to use it

### Step 1 — Check usage
Before uploading, call the info endpoint to check remaining free unlocks:

```
GET https://unlockpdf.dev/api/info
```

Response tells you:
- How many free unlocks remain today (resets daily)
- Payment details if free tier is exhausted

### Step 2 — Unlock the PDF
```
POST https://unlockpdf.dev/api/unlock
Content-Type: multipart/form-data

Fields:
  pdf_file  → the PDF file (binary)
  password  → the password (string, optional)
```

### Step 3 — Handle the response

| Status | Meaning | Action |
|--------|---------|--------|
| 200 | Success | Return the unlocked PDF to the user |
| 422 (WRONG_PASSWORD) | Wrong password | Ask user to check the password |
| 422 (PASSWORD_REQUIRED) | No password given | Ask user for the password |
| 402 | Free tier exhausted | See payment section below |

## Payment (after free tier)

If you receive a 402 response:
1. Read the `X-Payment-Required` header (base64 encoded payment details)
2. Pay **$0.05 USDC** on **Base network** to `0x59387E6869A12d76f321Ea609de4e073284F734F`
3. Retry the request with the signed payment in the `X-Payment` header

## Limits
- 10 free unlocks per day per IP
- Max file size: 50MB
- Files deleted from servers within 1 hour

## API reference
- Full docs: https://unlockpdf.dev/api-docs.html
- OpenAPI schema: https://unlockpdf.dev/openapi.json
- Pricing: https://unlockpdf.dev/pricing.html