GET /api/v2/receipt/{identifier}

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.

Path parameters

  • identifier string Required

    The identifier parameter

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • user_id string
    • shrimp string

      Default value is empty.

    • record object Required
      Hide record attributes Show record attributes object
      • identifier string Required
      • created number Required
      • updated number Required
      • key string | null
      • shortid string Required
      • state string Required

        Values are new, shared, revealed, burned, previewed, expired, or orphaned.

      • custid string | null
      • owner_id string | null
      • shared string | null
      • previewed string | null
      • revealed string | null
      • burned string | null
      • secret_ttl string | null Required
      • receipt_ttl string | null Required
      • lifespan string | null Required
      • secret_shortid string | null
      • secret_identifier string | null
      • recipients array[string] | null | string

      • share_domain string | null
      • has_passphrase boolean | null
      • is_previewed string | null
      • is_revealed string | null
      • is_burned string | null
      • is_destroyed string | null
      • is_expired string | null
      • is_orphaned string | null
      • memo string | null
      • kind string | null

        Any of:

        Values are generate or conceal.

        Value is .

      • received string | null
      • viewed string | null
      • is_viewed string | null
      • is_received string | null
      • secret_state string | null

        Values are new, shared, revealed, burned, previewed, expired, or orphaned.

      • natural_expiration string Required
      • expiration_in_seconds string | null Required
      • share_path string Required
      • burn_path string Required
      • receipt_path string Required
      • share_url string Required
      • receipt_url string Required
      • burn_url string Required
      • expiration number Required
    • details object
      Hide details attributes Show details attributes object
      • type string Required

        Value is record.

      • display_lines string | null Required
      • no_cache string | null
      • secret_realttl number | null
      • view_count string | null Required
      • has_passphrase string | null
      • can_decrypt string | null
      • secret_value string | null
      • show_secret string | null
      • show_receipt string | null
      • show_recipients string | null
      • is_orphaned string | null
      • is_expired string | null
  • 401 application/json

    Unauthorized - Authentication required

    Hide response attributes Show response attributes object
    • error string

      Error type identifier (e.g., "FormError")

    • message string Required

      Human-readable error message

    • field string

      Field that caused the error, if applicable

    • error_id string

      Unique error tracking identifier

  • 403 application/json

    Forbidden - Insufficient permissions

    Hide response attributes Show response attributes object
    • error string

      Error type identifier (e.g., "FormError")

    • message string Required

      Human-readable error message

    • field string

      Field that caused the error, if applicable

    • error_id string

      Unique error tracking identifier

  • 404 application/json

    Not Found - Resource does not exist

    Hide response attributes Show response attributes object
    • error string

      Error type identifier (e.g., "FormError")

    • message string Required

      Human-readable error message

    • field string

      Field that caused the error, if applicable

    • error_id string

      Unique error tracking identifier

  • 500 application/json

    Internal Server Error - Something went wrong

    Hide response attributes Show response attributes object
    • error string

      Error type identifier (e.g., "FormError")

    • message string Required

      Human-readable error message

    • field string

      Field that caused the error, if applicable

    • error_id string

      Unique error tracking identifier

GET /api/v2/receipt/{identifier}
curl \
 --request GET 'https://nz.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"
}