Skip to content
KismetKismetDevelopers
Beta accessllms.txt

Read a card request status

View .md

GET /v1/developer/guest/wallet/requests/{requestId}

Operation ID: getDeveloperWalletRequest

Read a card request status

Contract status

Section titled “Contract status”
Field Value
Maturity preview
Required capability guest_wallet_requests.write
Freshness class authenticated-state
Quota cost 1

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential’s installation grants; identifiers in the URL never grant access.

Request parameters

Section titled “Request parameters”
Name In Type Required Description
requestId path string yes

Request body

Section titled “Request body”

This operation has no JSON request body.

cURL

Section titled “cURL”

Set KISMET_API_ORIGIN=https://api.ksmt.app and configure KISMET_DEVELOPER_API_KEY in your environment. Run server-credential requests from your backend, not browser code.

Terminal window
curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/guest/wallet/requests/{requestId}" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json"

Responses

Section titled “Responses”
Status Meaning
200 Success.
400 Invalid request parameters or body.
401 Missing, invalid, expired, or inappropriate credential/session.
403 Credential lacks the required grant/capability, or an origin/CSRF check failed.
404 The authorized resource was not found.
409 Request conflicts with the installation environment or current state.
410 The single-use authentication challenge is no longer valid.
429 Rate limit or quota exceeded; inspect response metadata before retrying.
503 A required Kismet dependency is temporarily unavailable.

200 response schema

Section titled “200 response schema”

Content type: application/json. Required fields, nullable values, and nested structures are defined below.

View complete response schema 
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "status",
    "delivery",
    "deliveryState",
    "reference",
    "createdAt",
    "expiresAt",
    "livemode",
    "startUrl"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "in_progress",
        "succeeded",
        "expired",
        "revoked"
      ]
    },
    "delivery": {
      "type": "string",
      "enum": [
        "partner_link",
        "kismet_email"
      ]
    },
    "deliveryState": {
      "type": "string",
      "enum": [
        "not_requested",
        "pending",
        "sent",
        "failed"
      ]
    },
    "reference": {
      "type": [
        "null",
        "string"
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time"
    },
    "livemode": {
      "type": "boolean"
    },
    "startUrl": {
      "type": [
        "null",
        "string"
      ],
      "description": "Partner navigation context only. Never authenticates a guest. Null for Kismet-delivered email and closed requests."
    }
  }
}

Machine-readable sources

Section titled “Machine-readable sources”