Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: DocImprint Jobs API
version: 1.0.0
description: Verifiable document intelligence for AI agents. Extract, summarize, translate, or fact-check any URL or document. Responses include cryptographic evidence bundles with on-chain attestation. Pay per call in USDC via x402 or use an API key.
servers:
- url: https://api.docimprint.com
security:
- ApiKeyAuth:
- read
- write
- ApiKeyHeader:
- read
- write
tags:
- name: Jobs
paths:
/v1/jobs:
post:
summary: Queue batch extract jobs
operationId: createBatchJob
responses:
'202':
description: '{ job_id, status: queued, item_count }'
tags:
- Jobs
/v1/jobs/{id}:
get:
summary: Get async job status and progress
operationId: getJob
parameters:
- $ref: '#/components/parameters/PaymentSignature'
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Job status with progress_pct and result
'401':
$ref: '#/components/responses/WalletRequired'
'404':
description: Job not found
tags:
- Jobs
components:
responses:
WalletRequired:
description: '{ error: "Wallet identity required", code: "WALLET_REQUIRED", hint: "Pay-per-call (x402): payment-signature from your POST payment. Subscription: Authorization Bearer dr_live_..." }'
parameters:
PaymentSignature:
name: payment-signature
in: header
required: false
schema:
type: string
description: Verified x402 payment authorization (base64 JSON from the x402 protocol). Required on owner-scoped GET/DELETE when not using an API key. Must correspond to the payer that created the resource. X-Wallet-Address is deprecated and ignored.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: 'Bearer dr_live_... (or use X-API-Key header). Scopes: read (GET), write (POST/PUT/DELETE), admin (admin endpoints). Create keys at https://docimprint.com/pricing or via admin API.'
ApiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: 'Alternative to Authorization: Bearer header. Scopes same as ApiKeyAuth.'