Upload Files Under a Purchase Order with the API

Using Purchase Orders with API Uploads

📑 Upload Files Under a Purchase Order 

If you're using page-based billing, your files need to be tied to an approved purchase order (PO) through an Enterprise subscription. Here's how to do that through the API.

🔹 Step 1: Get Your Purchase Orders

Use:
GET /v1/user/purchase-orders

This returns a list of your POs and their current status.

Example PO:

Purchase order id example

Only POs in approved status with available pages can be used.

🔹 Step 2: Add the PO ID When Uploading

When uploading via: POST /v1/external/user/files

Include this in the request:

Purchase order id example

You can also build your own dropdown selector inside your platform that pulls PO data from this endpoint.