--- title: "Get an installation event" description: "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." --- `GET /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 | 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 | Name | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `eventId` | path | string | yes | | ## Request body This operation has no JSON request body. ## 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. ```sh curl --request GET \ "$KISMET_API_ORIGIN/v1/developer/events/{eventId}" \ --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \ --header "Accept: application/json" ``` ## 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 ```json { "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 Content type: `application/json`. Required fields, nullable values, and nested structures are defined below.
View complete response schema ```json { "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 } ] } ```
## Machine-readable sources - [This page as Markdown](/api/reference/get-developer-event.md) - [Developer API OpenAPI v0.7.25](/openapi.json)