Once a client signs the SAC (Spend Analysis Consent), we require access to their invoices to perform savings analysis and tracking. To simplify integration, we recommend partners to build a single standardized API endpoint that Rampart can call securely to retrieve invoice metadata. This endpoint will be registered by partners in the command center and a secret signing key will be shared by both parties.

​
Example Endpoint

Hosted by: You (Partner) Called by: Rampart’s Backend on a daily basis and directly when SAC is enabled by a client 
GET /rampart/invoices

​
Query Parameters

ParamTypeDescription
account_tokenstringUnique identifier for the client (provided by Rampart when )
from_datestringISO 8601 date (YYYY-MM-DD) — inclusive
to_datestringISO 8601 date (YYYY-MM-DD) — inclusive
cursorstring(Optional) Token with the value of an invoice ID to paginate from a previous request
limitinteger(Optional) Max number of invoices to return (default: 100)

​
Response format expected

{
	"total": 2748,
  "invoices": [
    {
      "invoice_id": "inv_001",
      "date": "2025-07-10",
      "file_url": "https://partner.com/files/inv_001.pdf",
      "vendor_hint": "STAPLES"
    },
    {
      "invoice_id": "inv_002",
      "date": "2025-07-10",
      "file_url": "https://partner.com/files/inv_002.pdf",
      "vendor_hint": "STAPLES"
    }
  ],
  "next_cursor": "inv_003"
}
  • All file_url values must be time-limited presigned URLs (valid for at least 1h).
  • We will download and process each invoice file asynchronously from the URL.