Skip to main content
POST
Validate a file

Authorizations

Authorization
string
header
required

Your secret key as a bearer token, e.g. Authorization: Bearer sk_live_…. Secret keys are server-side only.

Body

application/json

Validate one or more files against PDF/A or PDF/UA conformance levels. Each source carries its own profile (one or more codes). The request is synchronous by default — the response is 200 with { job } on completion, or 202 with pending: true if the job does not finish within ~27 s. An optional webhook is called when the job reaches a terminal status.

sources
any[]
required

List of files to validate. Each item must include a profile field. Even a single file must be wrapped in an array.

Required array length: 1 - 50 elements
async
boolean
default:false

When true, return 201 immediately with { job, pending: true } and let the webhook (if any) deliver the terminal result. When false (default), the request is synchronous — 200 on completion, or 202 with pending: true if the job does not finish within ~27 s.

webhook
any
metaData
any

Response

Sync completion (sync: true)

job
object