# MicroPDF

> PDF extraction API for AI agents. Native text and printed English OCR to Markdown and paginated JSON. Public beta on Base Sepolia testnet; no mainnet payments.

API base: https://api.micropdf.cloud
Current initial price: 1000 atomic USDC per selected page (0.001 test USDC). The returned quote is authoritative.
Limits: 20 MB, 50 pages, 24-hour source/result retention from upload.

## Integration resources
- [Guide](https://micropdf.cloud/docs/): Upload, quote, pay, poll, retrieve and delete.
- [Live OpenAPI](https://api.micropdf.cloud/openapi.json): Authoritative API schema.
- [Capabilities](https://api.micropdf.cloud/v1/capabilities): Current limits and pricing.
- [TypeScript client example](https://micropdf.cloud/examples/extract.ts): Uses official x402 SDK. Requires a dedicated funded test wallet and spending cap; submits a real testnet payment.

## Workflow
1. POST /v1/documents with multipart file or JSON public HTTPS url. Securely retain id and token.
2. POST /v1/documents/{id}/quotes with bearer token; optional one-based pages and ocr auto/never.
3. POST /v1/quotes/{id}/execute with bearer token and stable Idempotency-Key. Read HTTP 402 PAYMENT-REQUIRED. Validate recipient, resource, network and amount; use x402 v2 exact EVM on eip155:84532 to authorize. Retry same key with PAYMENT-SIGNATURE.
4. After HTTP 202, GET /v1/jobs/{id} until succeeded or failed. Job ID equals quote ID.
5. GET /v1/jobs/{id}/result?format=json or format=markdown. Inspect partial, per-page method and warnings.
6. DELETE /v1/documents/{id} to remove source and results early.

Keep tokens and wallet keys private. Never transmit a private key to MicroPDF. For PAYMENT_UNCERTAIN or PAYMENT_PENDING, stop creating payments and retain quote/transaction details for operator reconciliation. No automatic refunds. Layout/tables are heuristic. Handwriting, complex formulas and image descriptions are not supported. A real signed testnet settlement still needs end-to-end validation.