API & Integrations

Merion Developers

Technical documentation for approved partners and integrators of Merion's commercial debt-recovery platform.

Overview

What is the Merion API?

api.merion.com.au is the system-of-record hub that powers Merion's partner and client portals. It handles debt referrals, case updates, partner intake, form submissions, and billing events. The hub is not a general-purpose open API — most routes require an authenticated bearer token issued by auth.merion.com.au, or a portal-scoped session token. Access is available to approved partners and integrators only.

Public surface

What is publicly accessible?

Without authentication, the following endpoints respond:

GET https://api.merion.com.au/health
JSON status response. Useful for uptime monitoring.
GET https://api.merion.com.au/docs
Human-readable API documentation page.
GET https://api.merion.com.au/openapi.yaml
Machine-readable OpenAPI 3.x specification.
GET https://api.merion.com.au/.well-known/openid-configuration
OIDC discovery document (served by auth.merion.com.au).
POST https://api.merion.com.au/public/forms/{key}
Marketing and partner form intake. No token required. See the Forms API docs.

All other routes require a bearer token (OIDC, ES256, PKCE S256) or a portal session token. Unauthenticated requests to protected routes return 401 Unauthorized.

Access

Who can integrate?

The API is intended for:

  • Approved referral partners — accountants, bookkeepers, and business advisers in the Merion Partner Programme who need to submit referrals programmatically.
  • Approved integrators — software platforms or internal teams building integrations against Merion's platform on behalf of a contracted client.

To request access, email [email protected] with a brief description of your use case. The Merion team will issue credentials via the partner onboarding flow.

Documentation

Where to go next

  • Start here

    Getting Started

    Base URL, authentication model (OIDC/ES256/PKCE), and how to request access.

    Read more
  • Endpoints

    API Reference

    Every public endpoint — health, docs, OpenAPI spec, OIDC discovery — with curl examples and response shapes.

    Read more
  • Open intake

    Forms API

    The one genuinely open integration: POST /public/forms/{key} for marketing and partner form intake.

    Read more
  • Events

    Webhooks

    Stripe webhook handling and the partner webhook roadmap.

    Read more
  • Health & help

    Status & Support

    Live status page, the /health endpoint, and how to get support.

    Read more
Get started

Ready to integrate with Merion?

API access is available to approved partners and integrators. Contact us to start the conversation.