Skip to main content
Ask ChatGPT

Aprimo PM Reporting API Quick Start

A downloadable Claude skill that gets an AI agent productive against the Aprimo Reporting API in minutes. Install it, then ask the agent to help you enable Web Service Access on a report, authenticate, and build request URLs — including report parameters, response formats, and troubleshooting.

important

The Reporting API pulls data from Aprimo Productivity Management (PM/MPM) reports. It's a different thing from the Analytics API, which is DAM-only and works against a fixed query schema rather than per-report parameters — see the Aprimo DAM Analytics API Quick Start skill for that.

Download the Aprimo PM Reporting API Quick Start skill

What's in the package​

The download is a .zip containing a single skill folder, aprimo-pm-reporting-api-quickstart/, with one file:

  • SKILL.md — the skill instructions the agent reads: a 60-second setup, code examples, essential concepts, common tasks, and troubleshooting.

There's no bundled reference file, and deliberately so: unlike the DAM and PM REST APIs, the Reporting API has no fixed schema to bundle — every report is its own endpoint with its own report ID and its own report-specific parameters, defined per customer. The value this skill adds is in the mechanics that trip people up regardless of which report they're calling: URL construction, parameter encoding (single/list/range values), and the two independent authentication models.

What the skill covers​

  • Enabling access — turning on Web Service Access for a specific report in Aprimo (the domain right required, and the two auth options).
  • Authentication — both supported models: Basic Auth (report ID as username, the report's own Web Service Authentication Token as password) and OAuth 2.0 (the same Bearer token flow used across the rest of the Aprimo REST API) — with code examples for both.
  • Code examples — ready-to-adapt snippets in Python, JavaScript / TypeScript, and C#, covering both auth methods.
  • Essential concepts — the URL/type-suffix format, report parameter syntax (single, list, and range values, including multi-object prefixing), the four response formats (XSD, XML, JSON, PDF), and the full status code reference.
  • Common tasks — worked examples: fetching a report's schema first, filtering by date range and picklist, requesting a PDF, and submitting list- and multi-object parameters.
  • Troubleshooting — 401s from auth-type mismatches, 404s, 400s from missing report parameters, 206 partial-content responses (and why there's no client-side paging fix for those), and the concurrent-call timeout error specific to this API.

Install and use it​

  1. Download the package above and unzip it.
  2. Install it by placing the aprimo-pm-reporting-api-quickstart/ folder into a Claude skills directory — for example .claude/skills/ in your project or home directory.
  3. Use it — start a session and ask questions such as:
    • "Build a query for report 515 filtered to a date range and two task statuses."
    • "What's the difference between the list-value and range-value parameter syntax?"
    • "Why would I get a 206 instead of a 200?"

The agent loads the skill automatically when your request relates to the Aprimo Reporting API.

tip

The skill points the agent at the AI-readable documentation at developers.aprimo.com/llms.txt for deeper reference, so it can pull in more detail beyond what's bundled.