Get a hosted session
Get the current state of one of your hosted sessions. Once the session is `COMPLETED`, `result` holds the same result as `GET /v2/hosted-results/{code}`. Reading does not use up anything, so poll as often as you need. Use it when a redirect or a result code gets lost. It also returns sessions started from a Console link (Link Integration).
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
sessionId*string
ID of the session, as returned when it was issued.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.petify.petnow.io/v2/hosted-sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"success": true,
"data": {
"id": "3f2c9a1e-6d2b-4e6a-9c1a-7b8d5e4f3a21",
"linkId": null,
"action": "VERIFY",
"species": "DOG",
"integrationMethod": "SERVER_INTEGRATION",
"bindingSource": "SERVER_ISSUED",
"externalPetId": "customer-pet-42",
"bindingTrusted": true,
"status": "PROCESSING",
"outcome": null,
"errorCode": null,
"result": null,
"expiresAt": "2026-07-27T05:30:00Z",
"completedAt": null,
"createdAt": "2026-07-27T05:00:00Z"
}
}{
"errors": [
{
"code": "PETNOWB2B10000"
}
]
}{
"errors": [
{
"code": "PETNOWB2B10010"
}
]
}{
"errors": [
{
"code": "PETNOWB2B21004"
}
]
}