Reporting API

Pull an account's monthly totals — leads, appointments, booking rate, revenue — into your own reports with one bearer key.

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://app.onepath.ai/api/reporting/v1/accounts"

{
  "owner": { "type": "partner", "code": "your_agency", "name": "Your Agency" },
  "accounts": [
    {
      "id": 42,
      "name": "Wahoo Plumbing",
      "website": "callwahoo.com",
      "time_zone": "America/Chicago",
      "created_at": "2026-05-01T14:02:11Z"
    }
  ]
}

Every account in that list can be queried for its numbers with Account metrics. Two endpoints, both GET, both JSON.

What you can see

The API returns totals only. No leads, no customer names, phones or addresses, no conversations. If you need a number that is not one of the six in Account metrics, it is not available through this API.

Which accounts appear depends on who the key belongs to:

• A partner key sees the accounts that were referred by your agency and still have sharing turned on. An account owner can turn sharing off for your agency at any time in their OnePath settings; that account then disappears from your list and its metrics endpoint answers 404.
• An account key sees only that one account.

Getting a key

Keys are issued by OnePath — there is no self-serve page. Ask your OnePath contact for one. It arrives as a single string that begins with op_rk_; the whole string, prefix included, is the key. Replace YOUR_KEY in the examples on these pages with it. Keep it private: it is shown once and OnePath cannot recover it, only replace it. If a key leaks, ask for a new one and the old one is revoked.

Send it on every request as a bearer token:

Authorization: Bearer YOUR_KEY

Rate limits

• 60 requests per minute per key
• 30 requests per minute per IP address before authentication

Results for a given account and date range are cached for six hours, so calling the same range repeatedly returns quickly and does not count against anything but the request limit.

Errors

Every refusal has the same shape. Branch on error; show message to a human.

{ "error": "invalid_date_range", "message": "to must be on or after from" }