---
title: "Verifies a Semaphore proof"
method: POST
path: "/verifySemaphoreProof"
---

# Verifies a Semaphore proof

`POST /verifySemaphoreProof`

## Query parameters

- `maxRootAgeSeconds` integer

## Request body

- VerifySemaphoreProofRequest
  - `root` string, required
  - `signalHash` string, required
  - `nullifierHash` string, required
  - `externalNullifierHash` string, required
  - `proof` union[], required
    - union
      - FieldElement[]
      - G1[]
        - FieldElement[]

## Response `200`

Valid proof response

- VerifySemaphoreProofResponse
  - `root` string
  - `status` 'new' | 'failed' | 'pending' | 'mined'
  - `pendingValidAsOf` string, date-time
  - `minedValidAsOf` string, date-time, nullable

## Other responses

- `400` — Invalid proof or root not found
- `500` — Prover error

## Changes

- **2023-08-29** `447076339bfd` — 1 info
  - added the new optional `query` request parameter `maxRootAgeSeconds`
- **2023-05-29** `8e437603378d` — 2 warning, 1 info
  - added the new `failed` enum value to the `status` response property for the response status `200`
  - added the new `new` enum value to the `status` response property for the response status `200`
  - removed the `confirmed` enum value from the `status` response property for the response status `200`
- **2023-04-20** `790ca477d1ec` — 3 breaking, 5 warning, 2 info
  - added the new required request property `externalNullifierHash`
  - added the new required request property `nullifierHash`
  - added the new required request property `signalHash`
  - removed the request property `external_nullifier_hash`
  - …6 more
- **2023-03-24** `9599b8b9d3da` — 1 info
  - endpoint added
- **2022-06-09** `53a386390a03` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/worldcoin/apis/signup-sequencer/changes/verifySemaphoreProof/post.md)

---

[API](https://skmtc.dev/worldcoin/apis/signup-sequencer.md) · [All operations](https://skmtc.dev/worldcoin/apis/signup-sequencer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/worldcoin/signup-sequencer/revisions/eb6bc98df64f/schema)