Skip to content

Retrieve a person token ​

Retrieves a Person Token associated with an Account.

Returns ​

Response attributes ​

  • id (string) Unique identifier for the token.

  • object (string, value is "v2.core.account_person_token") String representing the object’s type. Objects of the same type share the same value of the object field.

  • created (timestamp) Time at which the token was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • expires_at (timestamp) Time at which the token will expire.

  • livemode (boolean) Has the value true if the token exists in live mode or the value false if the object exists in test mode.

  • used (boolean) Determines if the token has already been used (tokens can only be used once).

Error Codes ​

HTTP status codeCodeDescription
400non_connect_platform_accounts_v2_access_blockedNeeds to use the newer API version or onboard to Connect.
404not_foundThe resource wasn’t found.
429account_rate_limit_exceededAccount cannot exceed a configured concurrency rate limit on updates.
curl
curl https://api.stripe.com/v2/core/accounts/{{ACCOUNT_ID}}/person_tokens/perstok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-04-22.dahlia"

Response ​

json
{
  "id": "perstok_61RS0CgWt1xBt8M1Q16RS0Cg0WSQO5ZXUVpZxZ9tAIbY",
  "object": "v2.core.account_person_token",
  "created": "2025-11-17T14:00:00.000Z",
  "expires_at": "2025-11-17T14:10:00.000Z",
  "livemode": true,
  "used": true
}

Stripe API Reference - Self-contained docs reference, refreshed 2026-05-18