Skip to content

Get Card Status

Request

Get a card's current status.

Security
HTTPBearer
Path
account_idstring, (uuid)(Account Id)required
card_idstring, (uuid)(Card Id)required
Headers
x-jiko-idempotencystring, (uuid)(X-Jiko-Idempotency)required

A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

x-jiko-signaturestring(X-Jiko-Signature)required

Base64-encoded HMAC-SHA256 hash of x-jiko-idempotency + request pathname + body, keyed with your shared secret. See Authentication for the full algorithm and a code sample.

curl -i -X GET \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v1/jiko-accounts/{account_id}/cards/{card_id}/status/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string'

Responses

Successful Response

Bodyapplication/json
card_idstring, (uuid)(Card Id)required
statusstring(Status)required
Enum:"OPEN""LOCKED""CLOSED""NOT_ACTIVATED""FROZEN"
magstripe_statusstring or null(Magstripe Status)
Any of:
string
Enum:"OFF""ON"
object_typestring(Object Type)read-onlyrequired
Response
{ "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304", "status": "OPEN", "magstripe_status": "OFF", "object_type": "string" }