Get an installation event
View .mdGET /v1/developer/events/{eventId}
Operation ID: getDeveloperEvent
Returns one immutable event envelope. Unknown, foreign, and no-longer-granted events return 404. Server credentials only. Application, installation, collection, and TEST/LIVE scope are resolved from the credential. Legacy collection webhook destinations are separate. TEST and LIVE events are isolated; neither event grants charging, booking or marketing authority.
Contract status
Section titled “Contract status”| Field | Value |
|---|---|
| Maturity | beta |
| Required capability | events.read |
| 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 |
|---|---|---|---|---|
eventId |
path | string | yes |
Request body
Section titled “Request body”This operation has no JSON request body.
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.
curl --request GET \ "$KISMET_API_ORIGIN/v1/developer/events/{eventId}" \ --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. |
| 429 | Rate limit or quota exceeded; inspect response metadata before retrying. |
| 503 | A required Kismet dependency is temporarily unavailable. |
200 response example
Section titled “200 response example”{ "id": "evt_11111111-1111-4111-8111-111111111111", "type": "payment_method.added", "version": "2", "api_version": "2026-09-23", "created_at": "2026-09-23T12:00:01.000Z", "occurred_at": "2026-09-23T12:00:00.000Z", "timestamp": "2026-09-23T12:00:00.000Z", "environment": "TEST", "livemode": false, "source": { "application_id": "22222222-2222-4222-8222-222222222222", "installation_id": "33333333-3333-4333-8333-333333333333" }, "collection": { "id": "44444444-4444-4444-8444-444444444444", "slug": "sandbox-stays" }, "subject": { "type": "guest", "id": "dgs_55555555-5555-4555-8555-555555555555" }, "object": { "type": "payment_method", "id": "66666666-6666-4666-8666-666666666666" }, "data": { "payment_method_id": "66666666-6666-4666-8666-666666666666", "request_id": null, "reference": null }}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
{ "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "pattern": "^evt_[0-9a-f-]{36}$" }, "version": { "type": "string", "enum": [ "2" ] }, "api_version": { "type": "string", "enum": [ "2026-09-23" ] }, "created_at": { "type": "string", "format": "date-time" }, "occurred_at": { "type": "string", "format": "date-time" }, "timestamp": { "type": "string", "format": "date-time" }, "environment": { "type": "string", "enum": [ "TEST", "LIVE" ] }, "livemode": { "type": "boolean" }, "source": { "type": "object", "properties": { "application_id": { "type": "string", "format": "uuid" }, "installation_id": { "type": "string", "format": "uuid" } }, "required": [ "application_id", "installation_id" ], "additionalProperties": false }, "collection": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" } }, "required": [ "id", "slug" ], "additionalProperties": false }, "subject": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "guest" ] }, "id": { "type": "string", "pattern": "^dgs_[0-9a-f-]{36}$" } }, "required": [ "type", "id" ], "additionalProperties": false }, "type": { "type": "string", "enum": [ "payment_method.added" ] }, "object": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "payment_method" ] }, "id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "properties": { "payment_method_id": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9_-]+$" }, "request_id": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9_-]+$", "nullable": true }, "reference": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.:-]+$", "nullable": true } }, "required": [ "payment_method_id" ], "additionalProperties": false } }, "required": [ "id", "version", "api_version", "created_at", "occurred_at", "timestamp", "environment", "livemode", "source", "collection", "subject", "type", "object", "data" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^evt_[0-9a-f-]{36}$" }, "version": { "type": "string", "enum": [ "2" ] }, "api_version": { "type": "string", "enum": [ "2026-09-23" ] }, "created_at": { "type": "string", "format": "date-time" }, "occurred_at": { "type": "string", "format": "date-time" }, "timestamp": { "type": "string", "format": "date-time" }, "environment": { "type": "string", "enum": [ "TEST", "LIVE" ] }, "livemode": { "type": "boolean" }, "source": { "type": "object", "properties": { "application_id": { "type": "string", "format": "uuid" }, "installation_id": { "type": "string", "format": "uuid" } }, "required": [ "application_id", "installation_id" ], "additionalProperties": false }, "collection": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "slug": { "type": "string" } }, "required": [ "id", "slug" ], "additionalProperties": false }, "subject": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "guest" ] }, "id": { "type": "string", "pattern": "^dgs_[0-9a-f-]{36}$" } }, "required": [ "type", "id" ], "additionalProperties": false }, "type": { "type": "string", "enum": [ "guest.wallet_request.completed" ] }, "object": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "guest_wallet_request" ] }, "id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "type", "id" ], "additionalProperties": false }, "data": { "type": "object", "properties": { "request_id": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9_-]+$" }, "payment_method_id": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9_-]+$" }, "outcome": { "type": "string", "enum": [ "added", "already_present" ] }, "reference": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9_.:-]+$", "nullable": true } }, "required": [ "request_id", "payment_method_id", "outcome" ], "additionalProperties": false } }, "required": [ "id", "version", "api_version", "created_at", "occurred_at", "timestamp", "environment", "livemode", "source", "collection", "subject", "type", "object", "data" ], "additionalProperties": false } ]}