Connecting

Before you start sending queries and mutations, you need to know where to send requests and what headers to include. This page covers the basics of making a successful connection to the Ownright Partner API.

🔗 API endpoint

All GraphQL requests are sent to a single HTTPS endpoint:

POST https://api.ownright.com/partners/graphql

🧾 Required headers

Every request to the Partner API must include the following headers:

Header	HTTP Status
`Content-Type: application/json`	HMAC SHA256 signature of the request
`X-Ownright-Client-Id`	Your unique API client ID
`X-Ownright-API-Key`	Your long-lived API key used for authentication
`X-Ownright-Organization-Id`	A constant identifier for the Ownright platform

These headers are used to authenticate your requests and route them correctly.

📦 Example Request

Here’s an example of a basic GraphQL request using curl:

Example request

curl -X POST https://api.ownright.com/partners/graphql \
  -H "Content-Type: application/json" \
  -H "X-Ownright-Client-Id: your-client-id" \
  -H "X-Ownright-API-Key: your-api-key" \
  -H "X-Ownright-Organization-Id: ownright-prod-org" \
  -d '{"query": "query { referral(id: "gid://ownright/Referral/1") { id } }"}'

Use tools like Postman, Insomnia, or GraphiQL for easier request building and testing.

🔒 Need Help?

If you haven’t received your client ID or API key yet, read the Authentication documentation.

Receiving webhooks on matter updates Changelog

Getting Started

Core Concepts

Guides

API Reference

Queries

Mutations

Members

Webhooks

🔗 API endpoint

🧾 Required headers

📦 Example Request

🔒 Need Help?

​🔗 API endpoint

​🧾 Required headers

​📦 Example Request

​🔒 Need Help?

🔗 API endpoint

🧾 Required headers

📦 Example Request

🔒 Need Help?