Upload URL

Request a short-lived, presigned URL for uploading a PDF or image, for use with AWB Data Extraction.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This endpoint generates a temporary, secured URL that lets you upload a PDF without exposing your credentials.

The response contains three fields:

  • uploadUrl: the pre-signed URL to upload your file to
  • s3Url: the internal reference to pass to the AWB Data Extraction endpoint once the upload is done
  • expiresIn: validity in seconds (3600, i.e. 1 hour) for both uploadUrl and s3Url

Steps:

  1. Call this endpoint to obtain uploadUrl, s3Url and expiresIn.
  2. Send your PDF to uploadUrl with an HTTP PUT request, setting Content-Type to PDF. No other headers are required. A successful upload returns 200.
  3. Call ​AWB Data Extraction with type: PDF and data set to the s3Url value from step 1. The response returns the extracted AWB details (more details can be found in the dedicated page).

Important: the upload returns 200 as long as the URL is valid, including for an empty file or a file that is not a PDF. The content itself is only validated at the extraction step, so a 200 here confirms the transfer, not the validity of your document.

Both URLs expire 1 hour after they are issued, so the extraction call must be made within that window. If they expire, call this endpoint again to get a fresh pair and re-upload the file.


curl --request PUT \
  --url '<uploadUrl>' \
  --header 'Content-Disposition: attachment; filename="000-11223343.pdf"' \
  --header 'content-type: application/pdf' \
  --data @000-11223343.pdf
Body Params
string
required
Defaults to [email protected]

Requester email address

string
enum
required

Media type of the file to upload.

Allowed:
string
required
Defaults to master-awb.pdf

Name of the file being uploaded

Headers
string
required

API Key

Response

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json