Skip to main content
GET
/
v1
/
events
/
{eventId}
Get event details
curl --request GET \
  --url https://api.zuddl.com/v1/events/{eventId} \
  --header 'Authorization: <api-key>'
{
  "kind": "<string>",
  "url": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Huddle with zuddl.",
  "teamName": "General",
  "description": "join us to learn more about zuddl.",
  "identifier": "event-123",
  "startDate": "2025-04-11T12:30:00Z",
  "endDate": "2025-04-14T12:30:00Z",
  "timezone": "UTC/IST",
  "status": "ONGOING/COMPLETED",
  "type": "WEBINAR/FIELD_EVENT/EVENT",
  "eventFormat": "VIRTUAL/IN_PERSON/HYBRID",
  "websiteUrl": "https://zuddl.com",
  "parentEventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "location": {
    "venue": "<string>",
    "address": {
      "address": "<string>",
      "addressLine2": "<string>",
      "city": "San Francisco",
      "stateProvince": "<string>",
      "postalCode": "<string>",
      "country": "<string>"
    },
    "coordinates": {
      "latitude": "24.4194509",
      "longitude": "27.4194509"
    },
    "mapUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ_Q8bfYdGXj4Rz1s_sFHJqcA"
  },
  "virtualEventUrl": "https://zuddl.com",
  "createdAt": "2025-04-11T12:30:00Z",
  "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedAt": "2025-04-11T12:30:00Z",
  "updatedBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tags": [
    {
      "id": "tag1",
      "name": "Webinar",
      "color": "#AAFFEE",
      "categoryId": "category1",
      "categoryName": "Event type",
      "categoryColor": "#BBDDEE",
      "lastAppliedAt": "2025-09-01T06:31:35.711971Z",
      "usageCount": 2
    },
    {
      "id": "tag2",
      "name": "Field Event",
      "color": "#BBFFEE"
    }
  ]
}

Authorizations

Authorization
string
header
required

Provide your API key secret in the Authorization header

Path Parameters

eventId
string
required

Unique identifier of the event

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Response

Event details retrieved successfully

kind
string
url
string<uri>
id
string<uuid>

ID of the event

organizationId
string<uuid>

ID of the organization

name
string

Name of the event

Example:

"Huddle with zuddl."

teamName
string

TeamName of the event

Example:

"General"

description
string

Description of the event

Example:

"join us to learn more about zuddl."

identifier
string

Identifier of the event

Example:

"event-123"

startDate
string<date-time>

startDate of the event

Example:

"2025-04-11T12:30:00Z"

endDate
string<date-time>

endDate of the event

Example:

"2025-04-14T12:30:00Z"

timezone
string

Timezone of the event

Example:

"UTC/IST"

status
enum<string>

Status of the event

Available options:
UPCOMING,
ONGOING,
CANCELED,
COMPLETED
Example:

"ONGOING/COMPLETED"

type
enum<string>

Type of the event

Available options:
EVENT,
FIELD_EVENT,
WEBINAR,
THIRD_PARTY_EVENT
Example:

"WEBINAR/FIELD_EVENT/EVENT"

eventFormat
enum<string>

Format of the event

Available options:
VIRTUAL,
IN_PERSON,
HYBRID
Example:

"VIRTUAL/IN_PERSON/HYBRID"

websiteUrl
string

websiteUrl of the event

Example:

"https://zuddl.com"

parentEventId
string<uuid>

parentEventId of the event

location
object

location of the event

virtualEventUrl
string

virtualEventUrl of the event

Example:

"https://zuddl.com"

createdAt
string<date-time>

createdAt of the event

Example:

"2025-04-11T12:30:00Z"

createdBy
string<uuid>

createdBy of the event

updatedAt
string<date-time>

updatedAt of the event

Example:

"2025-04-11T12:30:00Z"

updatedBy
string<uuid>

updatedBy of the event

tags
object[]

Tags associated with the event

Example:
[
{
"id": "tag1",
"name": "Webinar",
"color": "#AAFFEE",
"categoryId": "category1",
"categoryName": "Event type",
"categoryColor": "#BBDDEE",
"lastAppliedAt": "2025-09-01T06:31:35.711971Z",
"usageCount": 2
},
{
"id": "tag2",
"name": "Field Event",
"color": "#BBFFEE"
}
]