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.


    • Related Articles

    • Purchase Orders

      If your organization uses Purchase Orders (POs) to manage billing, AccessibleDocs supports an easy and transparent process for creating and using them within the platform. This article covers how to create a PO and how to use it during the document ...

    • Uploading Documents via API

      ? Upload Documents Directly From Your Platform Use the File Upload API to submit files for accessibility processing from your own system or app. ? Upload Endpoint POST /v1/external/user/files ? Request Body Example: ? Fields Explained: name, ...

    • Retrieving & Downloading Files with the API

      ? Search, View, and Download Documents After uploading, you can use the API to list, inspect, and download files. ? Get All Files (Company Admins) GET /v1/external/admin/company/files Supports filters like: users (array of user IDs) tags, search, ...

    • How to Generate Your API Key

      To use the API, you’ll first need to generate your API key. Steps: Go to Settings > API Integration Under Generate API Key, click Generate API Key Your key will appear in the field — click Copy to use it in your system Use this key in your API calls ...

    • Using Webhooks to Get Document Status Updates

      ? Get Automatic Updates When Your Document Is Ready Want to receive real-time updates when your documents are processed? Use webhooks to automatically notify your system when a file is complete. ? Generate Your Webhook Secret Key Go to Settings > ...