API docs by Redocly

Karpura API (7.1.0)

Download OpenAPI specification:

Official Karpura API specification. Visit main website: Karpura.

  • API Key Required: All authenticated endpoints require a valid API key, which can be generated in the Karpura Admin Portal.
  • Role Inheritance: Newly generated API keys automatically inherit the creating user's roles.
  • Restricting Access: To scope down or limit an API key's permissions, create the key while logged in as a user account with limited roles.

Get API Status & Info

Returns the operational status, version, and deployment mode of the API.

Responses

Response samples

Content type
application/json
{
  • "info": {
    }
}

Get Minimal Organization Details

Returns bare minimum organization details associated with the authenticated API Key. Use this API to get your organization ID, which is required for all other org-specific API calls.

Authorizations:
BearerAuth

Responses

Response samples

Content type
application/json
{
  • "orgs_minimal": [
    ],
  • "pagination": {
    }
}

Get Event Types

Returns Event Types along with their scheduled slots and ticket categories for a specific organization.

Authorizations:
BearerAuth
path Parameters
org_id
required
integer

Unique Organization identifier

query Parameters
include_future
boolean
Default: false
Example: include_future=true

Filter to include Events and Slots whose booking opens in the future.

include_past
boolean
Default: false

Filter to include past Events and Slots

include_canceled
boolean
Default: false

Filter to include canceled Events

include_tags
boolean
Default: false
Example: include_tags=true

Include Event Category IDs associated with Events.

page_index
integer
Default: 0

Zero-based page index for pagination

page_size
integer
Default: 25
Example: page_size=25

Number of records to return per page

Responses

Response samples

Content type
application/json
{
  • "event_types": [
    ],
  • "pagination": {
    }
}

Create an Event Type

Creates a new Event Type along with event slots, and ticket structures for an organization.

Authorizations:
BearerAuth
path Parameters
org_id
required
integer

Unique Organization identifier

Request Body schema: application/json
required
name
required
string (EventName) <= 120 characters

Event Name

description
required
string (EventDescription) <= 500 characters

A short description of the Event

additional_details
string or null (EventAdditionalDetails)

Additional details formatted using Karpura Multimedia Format (supports rich text, structured layouts, and embedded images via the Karpura Admin Portal).

Critical: This property cannot be created or modified via the API. Edits must be made in the Admin Portal. When issuing a PATCH request to update an Event Type, you must include this property exactly as received from the prior GET call to prevent it from being cleared.
timezone_name
required
string (TimezoneName)

The official IANA time zone identifier for the location where the Event takes place.

Full list of valid IANA time zone identifiers
location
required
string (EventLocation) <= 240 characters

Event Venue or Location Name or Address

required
Array of objects (EventSlotsCreate) non-empty

Event Time slots and ticket configurations

sequence
integer or null (DisplaySequence)

Display sequence number used to sort the items.

tag_ids
Array of integers or null (EventCategoryIDs)

List of Event Category IDs associated with Events

Responses

Request samples

Content type
application/json
{
  • "name": "Annual Banquet",
  • "description": "Join our Annual Gala and Dinner...",
  • "additional_details": "{\"version\":1,\"bg_color...",
  • "timezone_name": "America/New_York",
  • "location": "Symphony Hall",
  • "slots": [
    ],
  • "sequence": null,
  • "tag_ids": null
}

Response samples

Content type
application/json
{
  • "event_types": [
    ],
  • "job_status": {
    }
}

Update an Event Type

Updates an existing Event Type.

Critical Update Behavior:
Unlike standard partial PATCH operations, this endpoint performs a full resource replacement:
  • Full Object Required: You must provide the complete object payload containing all fields, including those you do not intend to change.
  • Default Resets: Any omitted fields will automatically reset to their default values.
  • Cascading Deletions: Any Slot or Ticket left out of the array payload will be permanently deleted from the Event Type.
Authorizations:
BearerAuth
path Parameters
org_id
required
integer

Unique Organization identifier

id
required
integer

Unique Event Type identifier

Request Body schema: application/json
required
name
required
string (EventName) <= 120 characters

Event Name

description
required
string (EventDescription) <= 500 characters

A short description of the Event

additional_details
string or null (EventAdditionalDetails)

Additional details formatted using Karpura Multimedia Format (supports rich text, structured layouts, and embedded images via the Karpura Admin Portal).

Critical: This property cannot be created or modified via the API. Edits must be made in the Admin Portal. When issuing a PATCH request to update an Event Type, you must include this property exactly as received from the prior GET call to prevent it from being cleared.
timezone_name
required
string (TimezoneName)

The official IANA time zone identifier for the location where the Event takes place.

Full list of valid IANA time zone identifiers
location
required
string (EventLocation) <= 240 characters

Event Venue or Location Name or Address

required
Array of objects (EventSlotsUpdate) non-empty

Event Time slots and ticket configurations

sequence
integer or null
Default: null

Display sequence number used to sort the items.

tag_ids
Array of integers or null
Default: null

List of Event Category IDs associated with Events

Responses

Request samples

Content type
application/json
{
  • "name": "Annual Banquet",
  • "description": "Join our Annual Gala and Dinner...",
  • "additional_details": "{\"version\":1,\"bg_color...",
  • "timezone_name": "America/New_York",
  • "location": "Symphony Hall",
  • "slots": [
    ],
  • "sequence": 10,
  • "tag_ids": [
    ]
}

Response samples

Content type
application/json
{
  • "event_types": [
    ],
  • "job_status": {
    }
}

Delete an Event Type

Deletes an Event Type.

Authorizations:
BearerAuth
path Parameters
org_id
required
integer

Unique Organization identifier

id
required
integer

Unique Event Type identifier

Responses

Response samples

Content type
application/json
{
  • "job_status": {
    }
}