Skip to content

Stripe: Ephemeral keys schemas

1 Stripe schema with complete fields and constraints.

โ† Ephemeral keys operations ยท All schemas

Create an ephemeral key โ€” response body

FieldTypePresenceDescription and constraints
$objectRootEphemeral keys give the SDKs (like Stripe's mobile SDKs and Issuing Elements) temporary, scoped access to a specific
resource, such as a Customer, Issuing Card, or Identity VerificationSession, without exposing your secret API key.

Related guides: [Using Issuing Elements](https://docs.stripe.com/issuing/elements).
createdJSONRequired within parent
created (anyOf 1)integerAlternativeTime at which the object was created. Measured in seconds since the Unix epoch.
Format: unix-time
created (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
expiresJSONRequired within parent
expires (anyOf 1)integerAlternativeTime at which the key will expire. Measured in seconds since the Unix epoch.
Format: unix-time
expires (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
idstringRequired within parentUnique identifier for the object.
Maximum length: 5000
livemodebooleanRequired within parentIf the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringRequired within parentString representing the object's type. Objects of the same type share the same value.
Known values: ephemeral_key
secretstringOptionalThe key's secret. You can use this value to make authorized requests to the Stripe API.
Maximum length: 5000

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.