Events

Events API

Public API to manage events and attendees using an API key.

All endpoints are scoped to the company associated with the API key. An API key can only access and modify resources that belong to its own company.

Authentication

All requests must include the API key in the x-api-key header:

x-api-key: <your-api-key>

The middleware verifies the key against the auth service and resolves the company (referenceId) it belongs to. Requests with a missing or invalid key are rejected.

Base URL

https://api.wallettwo.com/events/v1/api

For the development environment, use https://dev-api.wallettwo.com/events/v1/api.

---

Events

List events

Returns all events that belong to the API key's company, including the total number of attendees for each one.

GET /event

Response

{
  "events": [
    {
      "id": "evt_123",
      "companyId": "cmp_abc",
      "name": "My Event",
      "location": "Madrid",
      "description": "...",
      "program": "...",
      "startDate": "2026-06-01T10:00:00.000Z",
      "endDate": "2026-06-01T18:00:00.000Z",
      "maxAttendees": 100,
      "price": 0,
      "currency": "EUR",
      "discountPrice": null,
      "discountPercentage": null,
      "contractRequiredToAttend": [],
      "contractRequiredToDiscount": [],
      "coverImage": null,
      "galleryImages": [],
      "chainId": null,
      "totalAttendees": 42
    }
  ]
}

---

Create an event

Creates a new event under the company of the API key. The companyId is taken automatically from the API key — it cannot be set in the body.

POST /event

Body

Field	Type	Description
name	string	Event name
location	string	Event location
description	string	Event description
program	string	Event program/agenda
startDate	ISO date	Start date
endDate	ISO date	End date
maxAttendees	number	Maximum number of attendees
price	number	Ticket price
currency	string	Currency code (e.g. EUR)
discountPrice	number	Discounted price
discountPercentage	number	Discount percentage
contractRequiredToAttend	string[]	NFT contract IDs required to attend
contractRequiredToDiscount	string[]	NFT contract IDs required to apply the discount
coverImage	string	Cover image URL
galleryImages	string[]	Gallery image URLs
chainId	number	Blockchain network ID

Response

Returns the newly created event.

{
  "id": "evt_123",
  "companyId": "cmp_abc",
  "name": "My Event",
  "...": "..."
}

---

Get an event

Returns a single event by ID, including totalAttendees. The event must belong to the API key's company; otherwise the response is Event not found.

GET /event/{eventId}

Response

{
  "id": "evt_123",
  "companyId": "cmp_abc",
  "name": "My Event",
  "totalAttendees": 42,
  "...": "..."
}

---

Update an event

Updates the provided fields of an existing event. Fields that are not included in the body are left unchanged.

POST /event/{eventId}

Body

Any subset of the same fields accepted by POST /event (except companyId, which is enforced from the API key).

Response

Returns the updated event.

---

Delete an event

Deletes the event and all its attendees. The event must belong to the API key's company.

DELETE /event/{eventId}

Response

{ "message": "Event deleted successfully" }

---

Attendees

All attendee endpoints are nested under an event and verify that the event belongs to the API key's company before doing anything.

List attendees

GET /event/{eventId}/attendees

Response

{
  "attendees": [
    {
      "id": "att_1",
      "eventId": "evt_123",
      "attendeeId": "usr_xyz",
      "confirmedAt": null
    }
  ]
}

---

Add an attendee

Adds an attendee to the event. Fails if the attendee is already registered.

POST /event/{eventId}/attendees

Body

Field	Type	Description
attendeeId	string	User ID to register as attendee

Response

Returns the newly created attendee record.

{
  "id": "att_1",
  "eventId": "evt_123",
  "attendeeId": "usr_xyz",
  "confirmedAt": null
}

---

Remove an attendee

Removes an attendee from the event.

DELETE /event/{eventId}/attendees

Body

Field	Type	Description
attendeeId	string	User ID of the attendee to remove

Response

{ "message": "Attendee removed successfully" }

---

Errors

Errors are returned with a descriptive message. Common cases:

Message	Cause
x-api-key header missing.	The x-api-key header was not sent
Invalid API key.	The auth service rejected the key
API key is not associated with a company	The API key has no referenceId
Event not found	The event does not exist or does not belong to the API key's company
Attendee ID is required	attendeeId is missing in the body
Attendee already invited	The user is already registered for the event
Attendee not found	The user is not registered for the event