curl --request POST \
  --url 'https://api.pdf.co/v1/pdf/convert/to/pdfa' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf"
  }'

const API_KEY = "YOUR_API_KEY";
const headers = {
  "Content-Type": "application/json",
  "x-api-key": API_KEY,
};

const submission = await fetch(
  "https://api.pdf.co/v1/pdf/convert/to/pdfa",
  {
    method: "POST",
    headers,
    body: JSON.stringify({
      url: "https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf",
      name: "sample-invoice-pdfa.pdf",
    }),
  }
);
if (!submission.ok) {
  throw new Error(`PDF.co submission HTTP ${submission.status}`);
}
const job = await submission.json();
if (job.error || !job.jobId) {
  throw new Error(job.message ?? "PDF.co request failed");
}

let result;
while (true) {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  const check = await fetch("https://api.pdf.co/v1/job/check", {
    method: "POST",
    headers,
    body: JSON.stringify({ jobid: job.jobId }),
  });
  if (!check.ok) {
    throw new Error(`PDF.co job-check HTTP ${check.status}`);
  }
  result = await check.json();
  if (result.status === "failed" || result.status === "aborted") break;
  if (result.error) {
    throw new Error(result.message ?? "PDF.co job-check failed");
  }
  if (result.status === "success") break;
  if (result.status !== "working") {
    throw new Error("Unexpected PDF.co job status");
  }
}

console.log(result.status, result.isCompliant);
console.log(result.url);
console.log(result.validationReportUrl);

import time

import requests

API_KEY = "YOUR_API_KEY"
headers = {"x-api-key": API_KEY}

submission = requests.post(
    "https://api.pdf.co/v1/pdf/convert/to/pdfa",
    headers=headers,
    json={
        "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf",
        "name": "sample-invoice-pdfa.pdf",
    },
    timeout=30,
)
submission.raise_for_status()
job = submission.json()
if job.get("error") or not job.get("jobId"):
    raise RuntimeError(job.get("message", "PDF.co request failed"))

while True:
    time.sleep(3)
    check = requests.post(
        "https://api.pdf.co/v1/job/check",
        headers=headers,
        json={"jobid": job["jobId"]},
        timeout=30,
    )
    check.raise_for_status()
    result = check.json()
    if result.get("status") in ("failed", "aborted"):
        break
    if result.get("error"):
        raise RuntimeError(result.get("message", "PDF.co job-check failed"))
    if result.get("status") == "success":
        break
    if result.get("status") != "working":
        raise RuntimeError("Unexpected PDF.co job status")

print(result.get("status"), result.get("isCompliant"))
print(result.get("url"))
print(result.get("validationReportUrl"))

using System.Collections.Generic;
using System.Net.Http;
using System.Text;
using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Serialize(new Dictionary<string, object>
{
    ["url"] = "https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf",
    ["name"] = "sample-invoice-pdfa.pdf",
});

var response = await client.PostAsync(
    "https://api.pdf.co/v1/pdf/convert/to/pdfa",
    new StringContent(payload, Encoding.UTF8, "application/json")
);
var json = await response.Content.ReadAsStringAsync();

// After a successful submission, use the returned jobId to poll
// https://api.pdf.co/v1/job/check. Handle HTTP/API request errors separately.
// Continue for "working"; stop only for "success", "failed" or "aborted".
// A missing or unknown status is an error, not a completed job.
Console.WriteLine(json);

OkHttpClient client = new OkHttpClient();

String jsonPayload = "{\"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf\", \"name\": \"sample-invoice-pdfa.pdf\"}";

Request request = new Request.Builder()
    .url("https://api.pdf.co/v1/pdf/convert/to/pdfa")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .addHeader("Content-Type", "application/json")
    .post(RequestBody.create(MediaType.parse("application/json"), jsonPayload))
    .build();

// After a successful submission, use the returned jobId to poll
// https://api.pdf.co/v1/job/check. Handle HTTP/API request errors separately.
// Continue for "working"; stop only for "success", "failed" or "aborted".
// A missing or unknown status is an error, not a completed job.
try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

<?php
$payload = json_encode([
    "url" => "https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf",
    "name" => "sample-invoice-pdfa.pdf",
]);

$curl = curl_init("https://api.pdf.co/v1/pdf/convert/to/pdfa");
curl_setopt_array($curl, [
    CURLOPT_HTTPHEADER => [
        "x-api-key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => $payload,
]);

// After a successful submission, use the returned jobId to poll
// https://api.pdf.co/v1/job/check. Handle HTTP/API request errors separately.
// Continue for "working"; stop only for "success", "failed" or "aborted".
// A missing or unknown status is an error, not a completed job.
echo curl_exec($curl);
curl_close($curl);

{
  "pageCount": 1,
  "error": false,
  "status": 200,
  "duration": 31,
  "name": "sample-invoice.pdf",
  "validationReportName": "sample-invoice-pdfa-validation.json",
  "jobId": "EXAMPLEJOBID0123456789ABCDEFGHIJ--166-400",
  "credits": 25,
  "remainingCredits": 400000
}

{
  "error": true,
  "status": 400,
  "message": "Bad request. Typically due to bad input parameters or unreachable input URLs (e.g., access restrictions like login or password)."
}

{
  "error": true,
  "status": 401,
  "message": "Unauthorized. Authentication is required and has failed or has not yet been provided."
}

{
  "error": true,
  "status": 402,
  "message": "Not enough credits."
}

{
  "error": true,
  "status": 403,
  "message": "Access forbidden for input URL."
}

{
  "error": true,
  "status": 404,
  "message": "The requested resource could not be found."
}

{
  "error": true,
  "status": 429,
  "message": "Too many requests in a given time period."
}

{
  "error": true,
  "status": 442,
  "message": "Input document is damaged or of incorrect type."
}

{
  "error": true,
  "status": 452,
  "message": "Invalid URL."
}

{
  "error": true,
  "status": 454,
  "message": "Invalid parameters."
}

{
  "error": true,
  "status": 500,
  "message": "Something went wrong. Please try again or contact support."
}