Retrieves the receipt (metadata) for a previously created secret. Returns the receipt's state, share and burn URLs, expiration details, and recipient information. For generated secrets viewed shortly after creation, the generated value may be included. The receipt tracks whether the associated secret has been viewed, burned, or expired.
GET
/api/v2/receipt/{identifier}
curl \
--request GET 'https://ca.onetimesecret.com/api/v2/receipt/{identifier}' \
--user "username:password"
Response examples (200)
{
"user_id": "string",
"shrimp": "",
"record": {
"identifier": "string",
"created": 42.0,
"updated": 42.0,
"key": "string",
"shortid": "string",
"state": "new",
"custid": "string",
"owner_id": "string",
"shared": "string",
"previewed": "string",
"revealed": "string",
"burned": "string",
"secret_ttl": "string",
"receipt_ttl": "string",
"lifespan": "string",
"secret_shortid": "string",
"secret_identifier": "string",
"recipients": [
"string"
],
"share_domain": "string",
"has_passphrase": true,
"is_previewed": "string",
"is_revealed": "string",
"is_burned": "string",
"is_destroyed": "string",
"is_expired": "string",
"is_orphaned": "string",
"memo": "string",
"kind": "generate",
"received": "string",
"viewed": "string",
"is_viewed": "string",
"is_received": "string",
"secret_state": "new",
"natural_expiration": "string",
"expiration_in_seconds": "string",
"share_path": "string",
"burn_path": "string",
"receipt_path": "string",
"share_url": "string",
"receipt_url": "string",
"burn_url": "string",
"expiration": 42.0
},
"details": {
"type": "record",
"display_lines": "string",
"no_cache": "string",
"secret_realttl": 42.0,
"view_count": "string",
"has_passphrase": "string",
"can_decrypt": "string",
"secret_value": "string",
"show_secret": "string",
"show_secret_link": "string",
"show_receipt_link": "string",
"show_receipt": "string",
"show_recipients": "string",
"is_orphaned": "string",
"is_expired": "string"
}
}
Response examples (401)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (403)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (404)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}
Response examples (500)
{
"error": "string",
"message": "string",
"field": "string",
"error_id": "string"
}