---
title: "Get Custom Event Schema"
method: GET
path: "/management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId}"
tags: ["Management"]
---

# Get Custom Event Schema

`GET /management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId}`

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/management/v1/projects/{projectId}/custom-event-schemas/{customEventSchemaId}`
- Auth: API key in header `X-Management-Id` and API key in header `X-Management-Token`

Retrieves a custom event schema.

> 📘 Custom Event Documentation
>
> Read [Custom Events](/prepare/custom-events) article to learn how custom events work in Voucherify.
>
>Read also the details about the [Track Custom Event](/api-reference/events/track-custom-event) endpoint and the [Custom Event Object](/api-reference/events/event-object).

## Response `200`

Returns the custom event schema.

- ManagementProjectsCustomEventSchemasGetResponseBody: Object representing a custom event schema.
  - `id` string, required: Unique identifier of the custom event schema.
  - `name` string, required: User-defined name of the custom event. This is also shown in **Project Settings** > **Event Schema** in the Voucherify Dashboard.
  - `schema` object, required: Object containing custom event schema and its custom attributes (metadata).
    - `properties` object, required: Defines custom event custom attributes (metadata).
  - `created_at` string, date-time, required: Timestamp representing the date and time when the custom event schema was created. The value is shown in the ISO 8601 format.
  - `updated_at` string, date-time: Timestamp representing the date and time when the custom event schema was updated. The value is shown in the ISO 8601 format.
  - `object` 'custom-event-schema', required: The type of the object represented by JSON.

## Other responses

- `401`: Returns an error if an invalid token was provided.
- `402`: Returns an error if the current plan does not include the Management API feature.
- `404`: Returns an error when a resource could not be found.

---

[API](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/revisions/4982266e0494?raw)