# API v1 (Legacy)

OpenAPI file: https://api.onetimesecret.com/doc/api-v1.json

## Description

This is version `2026-08-16` of this API documentation. Last update on Aug 16, 2026.
Our legacy REST API, which is in maintenance mode. Originally designed in the 2010s, requests are form encoded and responses are JSON with a simple, flat structure. Not recommended for new integrations. Receives only critical bug fixes and security patches.

## Servers

- Aotearoa New Zealand: https://nz.onetimesecret.com (Aotearoa New Zealand)

- Canada: https://ca.onetimesecret.com (Canada)

- Europe: https://eu.onetimesecret.com (Europe)

- United Kingdom: https://uk.onetimesecret.com (United Kingdom)

- United States: https://us.onetimesecret.com (United States)

- Development: http://localhost:3000 (Development)


## Topics

### [Authentications](https://api.onetimesecret.com/doc/api-v1/authentication.md)



## Endpoints

### [Authcheck](https://api.onetimesecret.com/doc/api-v1/group/endpoint-authcheck.md)

- [Authcheck](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_authcheck.md)


### [Create](https://api.onetimesecret.com/doc/api-v1/group/endpoint-create.md)

- [Create](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_create.md)


### [Generate](https://api.onetimesecret.com/doc/api-v1/group/endpoint-generate.md)

- [Generate](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_generate.md)


### [Metadata](https://api.onetimesecret.com/doc/api-v1/group/endpoint-metadata.md)

- [Show Receipt Recent](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_metadata_showreceiptrecent.md)

- [Burn Secret](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_metadata_burnsecret.md)

- [Show Receipt](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_metadata_showreceipt.md)

- [Show Receipt](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_metadata_showreceipt_post.md)


### [Private](https://api.onetimesecret.com/doc/api-v1/group/endpoint-private.md)

- [Show Receipt Recent](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_private_showreceiptrecent.md)

- [Burn Secret](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_private_burnsecret.md)

- [Show Receipt](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_private_showreceipt.md)

- [Show Receipt](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_private_showreceipt_post.md)


### [Receipt](https://api.onetimesecret.com/doc/api-v1/group/endpoint-receipt.md)

- [Show Receipt Recent](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_showreceiptrecent.md)

- [Burn Secret](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_receipt_burnsecret.md)

- [Show Receipt](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_showreceipt.md)

- [Show Receipt](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_showreceipt_post.md)


### [Secret](https://api.onetimesecret.com/doc/api-v1/group/endpoint-secret.md)

- [Show Secret](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_showsecret.md)


### [Share](https://api.onetimesecret.com/doc/api-v1/group/endpoint-share.md)

- [Share](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_share.md)


### [Status](https://api.onetimesecret.com/doc/api-v1/group/endpoint-status.md)

- [Status](https://api.onetimesecret.com/doc/api-v1/operation/operation-v1_status.md)




[Powered by Bump.sh](https://bump.sh)