Lookup Gift Instance

post

https://api.getkivly.com/api/v1/gift-cards/instances/lookup

Read an issued card by its redemption code. The code is sensitive; keep it out of URL/query logs. No balance is consumed.

Integration access is restricted to the credential's location. Pagination, monetary units and response envelopes are endpoint-specific; use the schema below. Do not assume that POST/PATCH requests are safe to retry after a timeout.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200Successful Response

401Authentication credentials were missing, invalid, or expired.

403The authenticated integration does not have access to this resource.

404Resource not found in the integration location.

409Action conflicts with the current resource state; reconcile before retrying.

422Validation Error

429Too many requests. Retry after the period indicated by the API.

500Unexpected server error.

503Shared integration limiter unavailable. Retry after the indicated delay.