Item Service API

The Item Service API enables batch file operations for Coupa items. Upload ZIP files containing multiple items, then retrieve status and download results.

Using this API, you can:

  • Upload files: Submit ZIP files for batch processing
  • Check status: Query job progress and file details
  • Download files: Retrieve processed files or sample templates

Prerequisites

You need:

  • OAuth 2.0 credentials for the Coupa platform
  • Access to request tokens using the client credentials flow
  • Appropriate scopes:
    • item_service.read for GET operations
    • item_service.write for POST operations

File requirements

  • Maximum file size: 25 MB
  • Maximum request size: 25 MB
  • Format: ZIP archives containing item data

Base URL

https://{organization_name}.coupahost.com/itemservice/api/externalapi/v1

Replace {organization_name} with your organization identifier.

API request flow

  1. Upload a ZIP file using POST /files/upload/zip
  2. Receive a jobId in the response
  3. Query status with GET /files/{jobId}
  4. Download processed files when status is SUCCESS