---
title: "Get participant"
method: GET
path: "/participants/{email}"
tags: ["Query Participants"]
---

# Get participant

`GET /participants/{email}`

This endpoint returns a participant associated with an email address. It provides a dedicated and lightweight alternative to using the email query parameter within the `GET /participants` endpoint for filtering participants by `email`.

## Path parameters

- `email` string, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved participant. Matching the provided email address.

- GetParticipantByEmailResponse
  - `message` object
    - `participant_code` string — Unique participant code associated with the customer generated by zerohash. This is the identifier that will be used in all other endpoints to refer to this customer.
    - `email` string — Customer email address, required. Note: zerohash will validate that the email is a correctly formatted `email`, and that the value is unique per-platform

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)