SignOps Email OTP API
The Email OTP API from SignOps — 6 operation(s) for email otp.
The Email OTP API from SignOps — 6 operation(s) for email otp.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/signops:signops-email-otp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SignOps Email OTP API
version: 1.0.0
description: 'Push notifications to Android, iOS and the web, login approval on a trusted phone, passkeys, authenticator codes and email OTP, on one API key and your own user ids. Errors are { error: { code, message } }. Test keys (sk_test_) send only to test devices and addresses and are not billed.'
contact:
email: hello@signops.dev
url: https://signops.dev/docs/
termsOfService: https://signops.dev/terms/
servers:
- url: https://api.signops.dev
security:
- secretKey: []
tags:
- name: Email OTP
paths:
/v1/otp/send:
post:
operationId: postOtpSend
summary: Send an email code
description: Makes a 6-digit code, valid 10 minutes, 5 tries. Live codes go from your verified domain; test keys send to your test addresses.
tags:
- Email OTP
security:
- secretKey: []
parameters:
- name: Idempotency-Key
in: header
required: false
description: The same key within 24 hours returns the first result instead of acting twice.
schema:
type: string
maxLength: 128
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
description: The address to send to.
format: email
app_name:
type: string
description: Shown in the email, up to 40 characters, no web or email addresses.
language:
type: string
description: en or hi.
enum:
- en
- hi
ip:
type: string
description: The user's IP address, for the per-IP limit and risk signals.
required:
- email
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
otp_id:
type: string
description: Code id, for verify.
status:
type: string
description: sent
email:
type: string
description: The address to send to.
format: email
expires_at:
type: string
description: ISO 8601 time.
format: date-time
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/otp/verify:
post:
operationId: postOtpVerify
summary: Check an email code
tags:
- Email OTP
security:
- secretKey: []
parameters:
- name: Idempotency-Key
in: header
required: false
description: The same key within 24 hours returns the first result instead of acting twice.
schema:
type: string
maxLength: 128
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
otp_id:
type: string
description: From send.
code:
type: string
description: The 6 digits the user typed.
required:
- otp_id
- code
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
valid:
type: boolean
description: Right or wrong.
otp_id:
type: string
description: Code id.
email:
type: string
description: 'When right: the address.'
tries_left:
type: integer
description: When wrong.
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/otp/{id}:
get:
operationId: getOtpById
summary: Get a code's status
tags:
- Email OTP
security:
- secretKey: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/magic-links:
post:
operationId: postMagicLinks
summary: Email a sign-in link
description: The link opens redirect_url with signops_token added. Valid 15 minutes, once.
tags:
- Email OTP
security:
- secretKey: []
parameters:
- name: Idempotency-Key
in: header
required: false
description: The same key within 24 hours returns the first result instead of acting twice.
schema:
type: string
maxLength: 128
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
description: The address to send to.
format: email
redirect_url:
type: string
description: https on your verified domain or a listed host; http://localhost with a test key.
app_name:
type: string
description: Shown in the email.
language:
type: string
description: en or hi.
enum:
- en
- hi
ip:
type: string
description: The user's IP address, for the per-IP limit and risk signals.
required:
- email
- redirect_url
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
link_id:
type: string
description: Link id.
status:
type: string
description: sent
email:
type: string
description: The address to send to.
format: email
redirect_url:
type: string
description: Where the link opens.
expires_at:
type: string
description: ISO 8601 time.
format: date-time
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/magic-links/verify:
post:
operationId: postMagicLinksVerify
summary: Check a link's token
tags:
- Email OTP
security:
- secretKey: []
parameters:
- name: Idempotency-Key
in: header
required: false
description: The same key within 24 hours returns the first result instead of acting twice.
schema:
type: string
maxLength: 128
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
token:
type: string
description: signops_token from the URL.
required:
- token
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
valid:
type: boolean
description: Right or wrong.
link_id:
type: string
description: Link id.
email:
type: string
description: When right.
redirect_url:
type: string
description: When right.
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/magic-links/{id}:
get:
operationId: getMagicLinksById
summary: Get a link's status
tags:
- Email OTP
security:
- secretKey: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
4XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
5XX:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Machine-readable code, like invalid_request, rate_limited or expired.
message:
type: string
description: Written for a developer to read.
required:
- code
- message
required:
- error
securitySchemes:
secretKey:
type: http
scheme: bearer
description: sk_live_... or sk_test_..., on your server only.
publishableKey:
type: http
scheme: bearer
description: pk_live_... or pk_test_..., used by the SDKs in apps and browsers.
externalDocs:
description: Docs
url: https://signops.dev/docs/