API reference · Owned cards

Read an owned card

GET/v1/wallets/{walletId}/cards/{soldCardId}

One bought card, with its codes hidden.

Permissioncards:read
AuthenticationSigned read
Staff-set limits it counts towardAll requests
.NET SDKanis.OwnedCards.GetAsync(walletId, soldCardId)

Parameters

NameInTypeNotes
walletIdrequiredpathUUIDA UUID, lower-case with hyphens.
soldCardIdrequiredpathUUIDA UUID, lower-case with hyphens.

Request

Signed with your key. No body, no nonce.

Headers: Signature-Input, Signature, X-Anis-Date, Accept-Language (optional). The SDKs set all of them for you.

Body: none.

Responses

StatusMeaningBody
200Success.MaskedCard
401Refused: not authenticated.Problem
403Refused: not allowed.Problem
404Refused: not found, or not yours.Problem
429Refused: a limit was reached.Problem
503No decision: a dependency was unavailable.Problem

Every answer is signed by Anis; the SDKs check it before you see it.

Refusals

Every refusal is a signed problem. Branch on its code; each links to what it means and what to do.

ErrorCodeStatus
Invalid credentialsinvalid_credentials401
Insufficient scopeinsufficient_scope403
Source address not allowedsource_ip_not_allowed403
Rate limitedrate_limited429
Account not authorisedbinding_not_authorized403
Account inactiveaccount_inactive403
Wallet not grantedwallet_not_granted404
Card not foundcard_not_found404
Service unavailabledependency_unavailable503
Request timeoutrequest_timeout504
Internal errorinternal_error500

Types

MaskedCard

FieldTypeNotes
idalways presentUUIDThe sold card’s id — what revealing one card takes.
orderOperationIdUUIDThe operation id of the order that bought it.
invoiceIdanyThe invoice it is on — what revealing a whole invoice takes.
cardobjectThe catalogue card it was sold from.
card.idUUIDThe catalogue card’s id.
card.nameLocalizedTextThe catalogue card’s name, in Arabic and English.
serialNumberMaskedstringThe serial number, partly hidden. The full codes come only from a reveal.
credentialAvailablealways presentbooleanWhether this card’s codes can be revealed.
purchasedAtstring (date-time)When it was bought.

LocalizedText

FieldTypeNotes
arstringThe Arabic text.
enstringThe English text.