Get PDF

Send a GET request to this endpoint to retrieve one generated PDF.

ℹ️

You will need to authenticate to use this API. See authentication.

Request


GET https://api.ojo.so/v1/pdf/:pdfId

Path Parameters

Parameter	Type	Description
pdfId	string	The `id` returned when the PDF was created or listed

cURL


curl --request GET \
  --url https://api.ojo.so/v1/pdf/<PDF ID> \
  --header 'Authorization: Bearer <API Key>'

Python


import requests
 
url = "https://api.ojo.so/v1/pdf/<PDF ID>"
headers = {"Authorization": "Bearer <API Key>"}
 
response = requests.get(url, headers=headers)
print(response.text)

JavaScript


const response = await fetch('https://api.ojo.so/v1/pdf/<PDF ID>', {
  headers: { Authorization: 'Bearer <API Key>' },
});
 
console.log(await response.json());

Response

200

Successfully retrieved the PDF.


{
  "id": "pdf-id.pdf",
  "pdfUrl": "<content domain>/path/to/document.pdf",
  "pages": 2,
  "createdAt": "2026-09-28T12:34:56Z"
}

pdfUrl has no scheme. Prefix it with https:// to fetch the file.

401

Your API key might be invalid or expired.


{
  "error": true,
  "message": "Unauthorized"
}

404

The specified PDF was not found. An image id is not found here either.


{
  "error": true,
  "message": "PDF not found"
}

429

You have hit your rate limit. You can view rate limit details here.


{
  "error": true,
  "message": "Too Many Requests"
}

500

An unexpected error occurred. Try again later. If the issue persists, please reach out.


{
  "error": true,
  "message": "Internal Server Error"
}