Retrieve a person associated with an account | Swagger Petstore

3 parameters

accountstringrequired

The unique identifier of the account.

personstringrequired

The unique identifier of the person to retrieve.

expandarray<string>optional

Specifies which fields in the response should be expanded.

2 status codes

200Returns the person object with all details including address, date of birth, verification status, and account association.

accountstringrequired

The account the person is associated with.

additional_tos_acceptancesobjectoptional

addressobjectoptional

address_kanaobjectoptional

address_kanjiobjectoptional

createdintegerrequired

Time at which the object was created. Measured in seconds since the Unix epoch.

dobobjectoptional

emailstringoptional

The person's email address. Also available for accounts where controller.requirement_collection is stripe.

first_namestringoptional

The person's first name. Also available for accounts where controller.requirement_collection is stripe.

first_name_kanastringoptional

The Kana variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

first_name_kanjistringoptional

The Kanji variation of the person's first name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

full_name_aliasesarray<string>optional

A list of alternate names or aliases that the person is known by. Also available for accounts where controller.requirement_collection is stripe.

future_requirementsobjectoptional

genderstringoptional

The person's gender.

idstringrequired

Unique identifier for the object.

id_number_providedbooleanoptional

Whether the person's id_number was provided. True if either the full ID number was provided or if only the required part of the ID number was provided (ex. last four of an individual's SSN for the US indicated by ssn_last_4_provided).

id_number_secondary_providedbooleanoptional

Whether the person's id_number_secondary was provided.

last_namestringoptional

The person's last name. Also available for accounts where controller.requirement_collection is stripe.

last_name_kanastringoptional

The Kana variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

last_name_kanjistringoptional

The Kanji variation of the person's last name (Japan only). Also available for accounts where controller.requirement_collection is stripe.

maiden_namestringoptional

The person's maiden name.

metadataobjectoptional

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

nationalitystringoptional

The country where the person is a national.

objectstringrequired

String representing the object's type. Objects of the same type share the same value.

Allowed:person

phonestringoptional

The person's phone number.

political_exposurestringoptional

Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.

Allowed:existingnone

registered_addressobjectoptional

relationshipobjectoptional

requirementsobjectoptional

ssn_last_4_providedbooleanoptional

Whether the last four digits of the person's Social Security number have been provided (U.S. only).

us_cfpb_dataobjectoptional

Demographic data related to the person.

verificationobjectoptional

defaultError response.

errorobjectrequired

Error handling

account and person must both identify existing resources. person must be a person associated with the specified account.

import { Stripe } from "swagger-petstore---openapi-3-0-sdk";

const client = new Stripe({
  baseUrl: "https://api.stripe.com/",
  auth: { basicAuth: { username: process.env.STRIPE_USERNAME!, password: process.env.STRIPE_PASSWORD! } },
});

const result = await client.accounts.getAccountPersonsPerson({
  account: "example",
  person: "example",
});

{
  "account": 42,
  "additional_tos_acceptances": {
    "account": {
      "date": "2026-01-15T09:00:00Z",
      "ip": "example_value",
      "user_agent": "example_value"
    }
  },
  "address": {
    "city": "example_value",
    "country": "GB",
    "line1": "example_value",
    "line2": "example_value",
    "postal_code": "example_value",
    "state": "example_value"
  },
  "address_kana": {
    "city": "example_value",
    "country": "GB",
    "line1": "example_value",
    "line2": "example_value",
    "postal_code": "example_value",
    "state": "example_value",
    "town": "example_value"
  },
  "address_kanji": {
    "city": "example_value",
    "country": "GB",
    "line1": "example_value",
    "line2": "example_value",
    "postal_code": "example_value",
    "state": "example_value",
    "town": "example_value"
  },
  "created": 1,
  "dob": {
    "day": 1,
    "month": 1,
    "year": 1
  },
  "email": "user@example.com",
  "first_name": "Example Name",
  "first_name_kana": "Example Name",
  "first_name_kanji": "Example Name",
  "full_name_aliases": [
    "Example Name"
  ],
  "future_requirements": {
    "alternatives": [
      {
        "alternative_fields_due": [
          "example_value"
        ],
        "original_fields_due": [
          "example_value"
        ]
      }
    ],
    "currently_due": [
      "example_value"
    ],
    "errors": [
      {
        "code": "external_request",
        "reason": "example_value",
        "requirement": "example_value"
      }
    ],
    "eventually_due": [
      "example_value"
    ],
    "past_due": [
      "example_value"
    ],
    "pending_verification": [
      "example_value"
    ]
  },
  "gender": "example_value",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "id_number_provided": true,
  "id_number_secondary_provided": true,
  "last_name": "Example Name",
  "last_name_kana": "Example Name",
  "last_name_kanji": "Example Name",
  "maiden_name": "Example Name",
  "nationality": "example_value",
  "object": "person",
  "phone": "+44 7700 900123",
  "political_exposure": "existing",
  "registered_address": {
    "city": "example_value",
    "country": "GB",
    "line1": "example_value",
    "line2": "example_value",
    "postal_code": "example_value",
    "state": "example_value"
  },
  "relationship": {
    "authorizer": true,
    "director": true,
    "executive": true,
    "legal_guardian": true,
    "owner": true,
    "percent_ownership": 1,
    "representative": true,
    "title": "Example Title"
  },
  "requirements": {
    "alternatives": [
      {
        "alternative_fields_due": [
          "example_value"
        ],
        "original_fields_due": [
          "example_value"
        ]
      }
    ],
    "currently_due": [
      "example_value"
    ],
    "errors": [
      {
        "code": "external_request",
        "reason": "example_value",
        "requirement": "example_value"
      }
    ],
    "eventually_due": [
      "example_value"
    ],
    "past_due": [
      "example_value"
    ],
    "pending_verification": [
      "example_value"
    ]
  },
  "ssn_last_4_provided": true,
  "us_cfpb_data": {
    "ethnicity_details": {
      "ethnicity": [
        "cuban"
      ],
      "ethnicity_other": "example_value"
    },
    "race_details": {
      "race": [
        "african_american"
      ],
      "race_other": "example_value"
    },
    "self_identified_gender": "example_value"
  },
  "verification": {
    "additional_document": {
      "back": "example_value",
      "details": "example_value",
      "details_code": "example_value",
      "front": "example_value"
    },
    "details": "example_value",
    "details_code": "example_value",
    "document": {
      "back": "example_value",
      "details": "example_value",
      "details_code": "example_value",
      "front": "example_value"
    },
    "status": "active"
  }
}

Request

Response

Errors