Certificate of Holding

Returns the certificate as a ready-made image (a PNG, 1080 px wide) plus its verify_url. Show the image in your app, let the user share it, or link to it. The QR code on the image opens the same verification page.

curl https://api.oropocket.com/partner/users/usr_xxx/certificate \
  -H "Authorization: Bearer oro_live_xxx"

{
  "success": true,
  "request_id": "req_xxx",
  "mode": "live",
  "data": {
    "user_code": "usr_xxx",
    "cert_no": "OP-POH-261014-3FA9C21B",
    "issued_on": "2026-10-14",
    "issued_at": "2026-10-14 19:42:10",
    "issued_at_display": "14 October 2026, 19:42 IST",
    "holder_name": "Asha Kumari",
    "name_verified": true,
    "gold_grams": 1.2346,
    "silver_grams": 25.5,
    "purity": { "gold": "24K · 999 Fine", "silver": "999 Fine" },
    "verify_url": "https://oro.vakeelji.com/verify/OP-POH-261014-3FA9C21B",
    "image_url": "https://api.oropocket.com/public/certificate-image/9f2c…e41.png",
    "image_width": 1080,
    "image_height": 1209,
    "reused": false
  }
}

Good to know

• It covers the user's full OroPocket holdings, the same as the certificate in the OroPocket app. That can be more than your sub-wallet view in /portfolio if the user also holds gold with us outside your app.
• One certificate per day while nothing changes. Calling again on the same day (IST) returns the same certificate, with reused: true, as long as the holdings and name are unchanged. Once they change, you get a new certificate with a new number. Old certificates stay verifiable: the auditor's page shows what each one certified when it was issued.
• The image never changes once issued, so you can cache it.
• Sandbox (oro_test_ keys) returns a fixed sample marked simulated: true, with a watermarked image and no verify_url.