Pro

Ranqa API

Send review invites after delivery or checkout. Use verifiedPurchase only when you have a real customer relationship (order/CRM).

Authentication

Create a key in the dashboard, then send it as a Bearer token. Keys start with rnq_.

Authorization: Bearer rnq_…

Manage API keys →

Create invites

Post one or many recipients. Set sendEmail to false if you’ll deliver the reviewUrl yourself (SMS, in-app).

POST https://ranqa.vercel.app/api/v1/invites
Content-Type: application/json
Authorization: Bearer rnq_…

{
  "recipients": [
    {
      "email": "customer@example.com",
      "orderId": "ORD-123",
      "verifiedPurchase": true
    }
  ],
  "sendEmail": true
}

verifiedPurchase: true marks the completed review as Verified customer. Misuse can lead to key revocation.

Organization snapshot

GET https://ranqa.vercel.app/api/v1/organization
Authorization: Bearer rnq_…

Webhooks

Register HTTPS endpoints in the dashboard to receive signed POST payloads when reviews are created, flagged, or invites completed.

POST https://ranqa.vercel.app/api/organizations/webhooks
Content-Type: application/json

{
  "organizationId": "…",
  "url": "https://your.app/webhooks/ranqa",
  "events": ["review.created", "review.flagged", "invite.completed"]
}

Each delivery includes X-Ranqa-Signature: HMAC-SHA256 of the raw JSON body using your endpoint secret.

Manage webhooks →

Invite a clear majority of recent customers — not only happy ones. Ranqa shows invite vs organic mix publicly.

How verification badges work →