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 Feedback 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: Feedback
paths:
/v1/feedback:
post:
summary: Submit feedback on an extraction result
operationId: submitFeedback
description: Report a good or bad result for any extraction. Optional — no auth required, rate-limited to 10 req/min. Agents should call this after processing a result to improve future quality.
requestBody:
content:
application/json:
schema:
type: object
properties:
rating:
type: string
enum:
- good
- bad
description: Overall quality rating
request_id:
type: string
description: x-request-id header value from the extraction response
category:
type: string
enum:
- wrong_output
- slow
- error
- other
message:
type: string
description: Optional free-text description of what went wrong or right
responses:
'200':
description: '{ received: true }'
'400':
description: Missing rating and message
tags:
- Feedback
components:
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.'