Petnow LogoPetnow

Get a result with a result code

Trade the one-time `petify_code` from the redirect for the result of the session. Call it from your server. The route accepts codes of sessions that your server issued and of Console link sessions. For a Console link session, `bindingTrusted` is `false`. The first read uses up the code. If that response gets lost, read again within the grace period (300 seconds by default): you get the same result with `alreadyConsumed: true`. A code expires about 10 minutes after the session completes. If the code is lost, use `GET /v2/hosted-sessions/{sessionId}`.

GET
/v2/hosted-results/{code}

Authorization

VendorApiKeyAuth
x-petnow-api-key<token>

An API key from the Petify Console. A server key can call every route. A client (app) key can only create capture sessions and upload images.

In: header

Path Parameters

code*string

The one-time result code from the redirect's petify_code, for example hrc_1a2b3c4d5e6f.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.petify.petnow.io/v2/hosted-results/string"

{
  "success": true,
  "data": {
    "sessionId": "3f2c9a1e-6d2b-4e6a-9c1a-7b8d5e4f3a21",
    "action": "REGISTER",
    "externalPetId": "customer-pet-42",
    "bindingTrusted": true,
    "outcome": "SUCCEEDED",
    "completedAt": "2026-07-27T05:04:12Z",
    "alreadyConsumed": false,
    "result": {
      "registered": true
    }
  }
}

{
  "errors": [
    {
      "code": "PETNOWB2B10000"
    }
  ]
}

{
  "errors": [
    {
      "code": "PETNOWB2B10010"
    }
  ]
}

{
  "errors": [
    {
      "code": "PETNOWB2B21005"
    }
  ]
}
{
  "errors": [
    {
      "code": "PETNOWB2B21006"
    }
  ]
}