# PostIssuingCardholders
From **Stripe API**.
`POST /v1/issuing/cardholders`
Creates a new Issuing Cardholder object that can be issued cards.
## Request body
- Required: true
### `application/x-www-form-urlencoded`
- Type: `object`
```json
{"additionalProperties":false,"properties":{"billing":{"description":"The cardholder's billing address.","properties":{"address":{"properties":{"city":{"maxLength":5000,"type":"string"},"country":{"maxLength":5000,"type":"string"},"line1":{"maxLength":5000,"type":"string"},"line2":{"maxLength":5000,"type":"string"},"postal_code":{"maxLength":5000,"type":"string"},"state":{"maxLength":5000,"type":"string"}},"required":["city","country","line1","postal_code"],"title":"required_address","type":"object"}},"required":["address"],"title":"billing_specs","type":"object"},"company":{"description":"Additional information about a `company` cardholder.","properties":{"tax_id":{"maxLength":5000,"type":"string"}},"title":"company_param","type":"object"},"email":{"description":"The cardholder's email address.","type":"string"},"expand":{"description":"Specifies which fields in the response should be expanded.","items":{"maxLength":5000,"type":"string"},"type":"array"},"individual":{"description":"Additional information about an `individual` cardholder.","properties":{"dob":{"properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"],"title":"date_of_birth_specs","type":"object"},"first_name":{"maxLength":5000,"type":"string"},"last_name":{"maxLength":5000,"type":"string"},"verification":{"properties":{"document":{"properties":{"back":{"maxLength":5000,"type":"string"},"front":{"maxLength":5000,"type":"string"}},"title":"person_verification_document_param","type":"object"}},"title":"person_verification_param","type":"object"}},"required":["first_name","last_name"],"title":"individual_param","type":"object"},"metadata":{"additionalProperties":{"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.","type":"object"},"name":{"description":"The cardholder's name. This will be printed on cards issued to them. The maximum length of this field is 24 characters.","type":"string"},"phone_number":{"description":"The cardholder's phone number. This will be transformed to [E.164](https://en.wikipedia.org/wiki/E.164) if it is not provided in that format already. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure#when-is-3d-secure-applied) for more details.","type":"string"},"spending_controls":{"description":"Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.","properties":{"allowed_categories":{"items":{"enum":["ac_refrigeration_repair","accounting_bookkeeping_services","advertising_services","agricultural_cooperative","airlines_air_carriers","airports_flying_fields","ambulance_services","amusement_parks_carnivals","antique_reproductions","antique_shops","aquariums","architectural_surveying_services","art_dealers_and_galleries","artists_supply_and_craft_shops","auto_and_home_supply_stores","auto_body_repair_shops","auto_paint_shops","auto_service_shops","automated_cash_disburse","automated_fuel_dispensers","automobile_associations","automotive_parts_and_accessories_stores","automotive_tire_stores","bail_and_bond_payments","bakeries","bands_orchestras","barber_and_beauty_shops","betting_casino_gambling","bicycle_shops","billiard_pool_establishments","boat_dealers","boat_rentals_and_leases","book_stores","books_periodicals_and_newspapers","bowling_alleys","bus_lines","business_secretarial_schools","buying_shopping_services","cable_satellite_and_other_pay_television_and_radio","camera_and_photographic_supply_stores","candy_nut_and_confectionery_stores","car_and_truck_dealers_new_used","car_and_truck_dealers_used_only","car_rental_agencies","car_washes","carpentry_services","carpet_upholstery_cleaning","caterers","charitable_and_social_service_organizations_fundraising","chemicals_and_allied_products","child_care_services","childrens_and_infants_wear_stores","chiropodists_podiatrists","chiropractors","cigar_stores_and_stands","civic_social_fraternal_associations","cleaning_and_maintenance","clothing_rental","colleges_universities","commercial_equipment","commercial_footwear","commercial_photography_art_and_graphics","commuter_transport_and_ferries","computer_network_services","computer_programming","computer_repair","computer_software_stores","computers_peripherals_and_software","concrete_work_services","construction_materials","consulting_public_relations","correspondence_schools","cosmetic_stores","counseling_services","country_clubs","courier_services","court_costs","credit_reporting_agencies","cruise_lines","dairy_products_stores","dance_hall_studios_schools","dating_escort_services","dentists_orthodontists","department_stores","detective_agencies","digital_goods_applications","digital_goods_games","digital_goods_large_volume","digital_goods_media","direct_marketing_catalog_merchant","direct_marketing_combination_catalog_and_retail_merchant","direct_marketing_inbound_telemarketing","direct_marketing_insurance_services","direct_marketing_other","direct_marketing_outbound_telemarketing","direct_marketing_subscription","direct_marketing_travel","discount_stores","doctors","door_to_door_sales","drapery_window_covering_and_upholstery_stores","drinking_places","drug_stores_and_pharmacies","drugs_drug_proprietaries_and_druggist_sundries","dry_cleaners","durable_goods","duty_free_stores","eating_places_restaurants","educational_services","electric_razor_stores","electrical_parts_and_equipment","electrical_services","electronics_repair_shops","electronics_stores","elementary_secondary_schools","employment_temp_agencies","equipment_rental","exterminating_services","family_clothing_stores","fast_food_restaurants","financial_institutions","fines_government_administrative_entities","fireplace_fireplace_screens_and_accessories_stores","floor_covering_stores","florists","florists_supplies_nursery_stock_and_flowers","freezer_and_locker_meat_provisioners","fuel_dealers_non_automotive","funeral_services_crematories","furniture_home_furnishings_and_equipment_stores_except_appliances","furniture_repair_refinishing","furriers_and_fur_shops","general_services","gift_card_novelty_and_souvenir_shops","glass_paint_and_wallpaper_stores","glassware_crystal_stores","golf_courses_public","government_services","grocery_stores_supermarkets","hardware_equipment_and_supplies","hardware_stores","health_and_beauty_spas","hearing_aids_sales_and_supplies","heating_plumbing_a_c","hobby_toy_and_game_shops","home_supply_warehouse_stores","hospitals","hotels_motels_and_resorts","household_appliance_stores","industrial_supplies","information_retrieval_services","insurance_default","insurance_underwriting_premiums","intra_company_purchases","jewelry_stores_watches_clocks_and_silverware_stores","landscaping_services","laundries","laundry_cleaning_services","legal_services_attorneys","luggage_and_leather_goods_stores","lumber_building_materials_stores","manual_cash_disburse","marinas_service_and_supplies","masonry_stonework_and_plaster","massage_parlors","medical_and_dental_labs","medical_dental_ophthalmic_and_hospital_equipment_and_supplies","medical_services","membership_organizations","mens_and_boys_clothing_and_accessories_stores","mens_womens_clothing_stores","metal_service_centers","miscellaneous","miscellaneous_apparel_and_accessory_shops","miscellaneous_auto_dealers","miscellaneous_business_services","miscellaneous_food_stores","miscellaneous_general_merchandise","miscellaneous_general_services","miscellaneous_home_furnishing_specialty_stores","miscellaneous_publishing_and_printing","miscellaneous_recreation_services","miscellaneous_repair_shops","miscellaneous_specialty_retail","mobile_home_dealers","motion_picture_theaters","motor_freight_carriers_and_trucking","motor_homes_dealers","motor_vehicle_supplies_and_new_parts","motorcycle_shops_and_dealers","motorcycle_shops_dealers","music_stores_musical_instruments_pianos_and_sheet_music","news_dealers_and_newsstands","non_fi_money_orders","non_fi_stored_value_card_purchase_load","nondurable_goods","nurseries_lawn_and_garden_supply_stores","nursing_personal_care","office_and_commercial_furniture","opticians_eyeglasses","optometrists_ophthalmologist","orthopedic_goods_prosthetic_devices","osteopaths","package_stores_beer_wine_and_liquor","paints_varnishes_and_supplies","parking_lots_garages","passenger_railways","pawn_shops","pet_shops_pet_food_and_supplies","petroleum_and_petroleum_products","photo_developing","photographic_photocopy_microfilm_equipment_and_supplies","photographic_studios","picture_video_production","piece_goods_notions_and_other_dry_goods","plumbing_heating_equipment_and_supplies","political_organizations","postal_services_government_only","precious_stones_and_metals_watches_and_jewelry","professional_services","public_warehousing_and_storage","quick_copy_repro_and_blueprint","railroads","real_estate_agents_and_managers_rentals","record_stores","recreational_vehicle_rentals","religious_goods_stores","religious_organizations","roofing_siding_sheet_metal","secretarial_support_services","security_brokers_dealers","service_stations","sewing_needlework_fabric_and_piece_goods_stores","shoe_repair_hat_cleaning","shoe_stores","small_appliance_repair","snowmobile_dealers","special_trade_services","specialty_cleaning","sporting_goods_stores","sporting_recreation_camps","sports_and_riding_apparel_stores","sports_clubs_fields","stamp_and_coin_stores","stationary_office_supplies_printing_and_writing_paper","stationery_stores_office_and_school_supply_stores","swimming_pools_sales","t_ui_travel_germany","tailors_alterations","tax_payments_government_agencies","tax_preparation_services","taxicabs_limousines","telecommunication_equipment_and_telephone_sales","telecommunication_services","telegraph_services","tent_and_awning_shops","testing_laboratories","theatrical_ticket_agencies","timeshares","tire_retreading_and_repair","tolls_bridge_fees","tourist_attractions_and_exhibits","towing_services","trailer_parks_campgrounds","transportation_services","travel_agencies_tour_operators","truck_stop_iteration","truck_utility_trailer_rentals","typesetting_plate_making_and_related_services","typewriter_stores","u_s_federal_government_agencies_or_departments","uniforms_commercial_clothing","used_merchandise_and_secondhand_stores","utilities","variety_stores","veterinary_services","video_amusement_game_supplies","video_game_arcades","video_tape_rental_stores","vocational_trade_schools","watch_jewelry_repair","welding_repair","wholesale_clubs","wig_and_toupee_stores","wires_money_orders","womens_accessory_and_specialty_shops","womens_ready_to_wear_stores","wrecking_and_salvage_yards"],"maxLength":5000,"type":"string"},"type":"array"},"blocked_categories":{"items":{"enum":["ac_refrigeration_repair","accounting_bookkeeping_services","advertising_services","agricultural_cooperative","airlines_air_carriers","airports_flying_fields","ambulance_services","amusement_parks_carnivals","antique_reproductions","antique_shops","aquariums","architectural_surveying_services","art_dealers_and_galleries","artists_supply_and_craft_shops","auto_and_home_supply_stores","auto_body_repair_shops","auto_paint_shops","auto_service_shops","automated_cash_disburse","automated_fuel_dispensers","automobile_associations","automotive_parts_and_accessories_stores","automotive_tire_stores","bail_and_bond_payments","bakeries","bands_orchestras","barber_and_beauty_shops","betting_casino_gambling","bicycle_shops","billiard_pool_establishments","boat_dealers","boat_rentals_and_leases","book_stores","books_periodicals_and_newspapers","bowling_alleys","bus_lines","business_secretarial_schools","buying_shopping_services","cable_satellite_and_other_pay_television_and_radio","camera_and_photographic_supply_stores","candy_nut_and_confectionery_stores","car_and_truck_dealers_new_used","car_and_truck_dealers_used_only","car_rental_agencies","car_washes","carpentry_services","carpet_upholstery_cleaning","caterers","charitable_and_social_service_organizations_fundraising","chemicals_and_allied_products","child_care_services","childrens_and_infants_wear_stores","chiropodists_podiatrists","chiropractors","cigar_stores_and_stands","civic_social_fraternal_associations","cleaning_and_maintenance","clothing_rental","colleges_universities","commercial_equipment","commercial_footwear","commercial_photography_art_and_graphics","commuter_transport_and_ferries","computer_network_services","computer_programming","computer_repair","computer_software_stores","computers_peripherals_and_software","concrete_work_services","construction_materials","consulting_public_relations","correspondence_schools","cosmetic_stores","counseling_services","country_clubs","courier_services","court_costs","credit_reporting_agencies","cruise_lines","dairy_products_stores","dance_hall_studios_schools","dating_escort_services","dentists_orthodontists","department_stores","detective_agencies","digital_goods_applications","digital_goods_games","digital_goods_large_volume","digital_goods_media","direct_marketing_catalog_merchant","direct_marketing_combination_catalog_and_retail_merchant","direct_marketing_inbound_telemarketing","direct_marketing_insurance_services","direct_marketing_other","direct_marketing_outbound_telemarketing","direct_marketing_subscription","direct_marketing_travel","discount_stores","doctors","door_to_door_sales","drapery_window_covering_and_upholstery_stores","drinking_places","drug_stores_and_pharmacies","drugs_drug_proprietaries_and_druggist_sundries","dry_cleaners","durable_goods","duty_free_stores","eating_places_restaurants","educational_services","electric_razor_stores","electrical_parts_and_equipment","electrical_services","electronics_repair_shops","electronics_stores","elementary_secondary_schools","employment_temp_agencies","equipment_rental","exterminating_services","family_clothing_stores","fast_food_restaurants","financial_institutions","fines_government_administrative_entities","fireplace_fireplace_screens_and_accessories_stores","floor_covering_stores","florists","florists_supplies_nursery_stock_and_flowers","freezer_and_locker_meat_provisioners","fuel_dealers_non_automotive","funeral_services_crematories","furniture_home_furnishings_and_equipment_stores_except_appliances","furniture_repair_refinishing","furriers_and_fur_shops","general_services","gift_card_novelty_and_souvenir_shops","glass_paint_and_wallpaper_stores","glassware_crystal_stores","golf_courses_public","government_services","grocery_stores_supermarkets","hardware_equipment_and_supplies","hardware_stores","health_and_beauty_spas","hearing_aids_sales_and_supplies","heating_plumbing_a_c","hobby_toy_and_game_shops","home_supply_warehouse_stores","hospitals","hotels_motels_and_resorts","household_appliance_stores","industrial_supplies","information_retrieval_services","insurance_default","insurance_underwriting_premiums","intra_company_purchases","jewelry_stores_watches_clocks_and_silverware_stores","landscaping_services","laundries","laundry_cleaning_services","legal_services_attorneys","luggage_and_leather_goods_stores","lumber_building_materials_stores","manual_cash_disburse","marinas_service_and_supplies","masonry_stonework_and_plaster","massage_parlors","medical_and_dental_labs","medical_dental_ophthalmic_and_hospital_equipment_and_supplies","medical_services","membership_organizations","mens_and_boys_clothing_and_accessories_stores","mens_womens_clothing_stores","metal_service_centers","miscellaneous","miscellaneous_apparel_and_accessory_shops","miscellaneous_auto_dealers","miscellaneous_business_services","miscellaneous_food_stores","miscellaneous_general_merchandise","miscellaneous_general_services","miscellaneous_home_furnishing_specialty_stores","miscellaneous_publishing_and_printing","miscellaneous_recreation_services","miscellaneous_repair_shops","miscellaneous_specialty_retail","mobile_home_dealers","motion_picture_theaters","motor_freight_carriers_and_trucking","motor_homes_dealers","motor_vehicle_supplies_and_new_parts","motorcycle_shops_and_dealers","motorcycle_shops_dealers","music_stores_musical_instruments_pianos_and_sheet_music","news_dealers_and_newsstands","non_fi_money_orders","non_fi_stored_value_card_purchase_load","nondurable_goods","nurseries_lawn_and_garden_supply_stores","nursing_personal_care","office_and_commercial_furniture","opticians_eyeglasses","optometrists_ophthalmologist","orthopedic_goods_prosthetic_devices","osteopaths","package_stores_beer_wine_and_liquor","paints_varnishes_and_supplies","parking_lots_garages","passenger_railways","pawn_shops","pet_shops_pet_food_and_supplies","petroleum_and_petroleum_products","photo_developing","photographic_photocopy_microfilm_equipment_and_supplies","photographic_studios","picture_video_production","piece_goods_notions_and_other_dry_goods","plumbing_heating_equipment_and_supplies","political_organizations","postal_services_government_only","precious_stones_and_metals_watches_and_jewelry","professional_services","public_warehousing_and_storage","quick_copy_repro_and_blueprint","railroads","real_estate_agents_and_managers_rentals","record_stores","recreational_vehicle_rentals","religious_goods_stores","religious_organizations","roofing_siding_sheet_metal","secretarial_support_services","security_brokers_dealers","service_stations","sewing_needlework_fabric_and_piece_goods_stores","shoe_repair_hat_cleaning","shoe_stores","small_appliance_repair","snowmobile_dealers","special_trade_services","specialty_cleaning","sporting_goods_stores","sporting_recreation_camps","sports_and_riding_apparel_stores","sports_clubs_fields","stamp_and_coin_stores","stationary_office_supplies_printing_and_writing_paper","stationery_stores_office_and_school_supply_stores","swimming_pools_sales","t_ui_travel_germany","tailors_alterations","tax_payments_government_agencies","tax_preparation_services","taxicabs_limousines","telecommunication_equipment_and_telephone_sales","telecommunication_services","telegraph_services","tent_and_awning_shops","testing_laboratories","theatrical_ticket_agencies","timeshares","tire_retreading_and_repair","tolls_bridge_fees","tourist_attractions_and_exhibits","towing_services","trailer_parks_campgrounds","transportation_services","travel_agencies_tour_operators","truck_stop_iteration","truck_utility_trailer_rentals","typesetting_plate_making_and_related_services","typewriter_stores","u_s_federal_government_agencies_or_departments","uniforms_commercial_clothing","used_merchandise_and_secondhand_stores","utilities","variety_stores","veterinary_services","video_amusement_game_supplies","video_game_arcades","video_tape_rental_stores","vocational_trade_schools","watch_jewelry_repair","welding_repair","wholesale_clubs","wig_and_toupee_stores","wires_money_orders","womens_accessory_and_specialty_shops","womens_ready_to_wear_stores","wrecking_and_salvage_yards"],"maxLength":5000,"type":"string"},"type":"array"},"spending_limits":{"items":{"properties":{"amount":{"type":"integer"},"categories":{"items":{"enum":["ac_refrigeration_repair","accounting_bookkeeping_services","advertising_services","agricultural_cooperative","airlines_air_carriers","airports_flying_fields","ambulance_services","amusement_parks_carnivals","antique_reproductions","antique_shops","aquariums","architectural_surveying_services","art_dealers_and_galleries","artists_supply_and_craft_shops","auto_and_home_supply_stores","auto_body_repair_shops","auto_paint_shops","auto_service_shops","automated_cash_disburse","automated_fuel_dispensers","automobile_associations","automotive_parts_and_accessories_stores","automotive_tire_stores","bail_and_bond_payments","bakeries","bands_orchestras","barber_and_beauty_shops","betting_casino_gambling","bicycle_shops","billiard_pool_establishments","boat_dealers","boat_rentals_and_leases","book_stores","books_periodicals_and_newspapers","bowling_alleys","bus_lines","business_secretarial_schools","buying_shopping_services","cable_satellite_and_other_pay_television_and_radio","camera_and_photographic_supply_stores","candy_nut_and_confectionery_stores","car_and_truck_dealers_new_used","car_and_truck_dealers_used_only","car_rental_agencies","car_washes","carpentry_services","carpet_upholstery_cleaning","caterers","charitable_and_social_service_organizations_fundraising","chemicals_and_allied_products","child_care_services","childrens_and_infants_wear_stores","chiropodists_podiatrists","chiropractors","cigar_stores_and_stands","civic_social_fraternal_associations","cleaning_and_maintenance","clothing_rental","colleges_universities","commercial_equipment","commercial_footwear","commercial_photography_art_and_graphics","commuter_transport_and_ferries","computer_network_services","computer_programming","computer_repair","computer_software_stores","computers_peripherals_and_software","concrete_work_services","construction_materials","consulting_public_relations","correspondence_schools","cosmetic_stores","counseling_services","country_clubs","courier_services","court_costs","credit_reporting_agencies","cruise_lines","dairy_products_stores","dance_hall_studios_schools","dating_escort_services","dentists_orthodontists","department_stores","detective_agencies","digital_goods_applications","digital_goods_games","digital_goods_large_volume","digital_goods_media","direct_marketing_catalog_merchant","direct_marketing_combination_catalog_and_retail_merchant","direct_marketing_inbound_telemarketing","direct_marketing_insurance_services","direct_marketing_other","direct_marketing_outbound_telemarketing","direct_marketing_subscription","direct_marketing_travel","discount_stores","doctors","door_to_door_sales","drapery_window_covering_and_upholstery_stores","drinking_places","drug_stores_and_pharmacies","drugs_drug_proprietaries_and_druggist_sundries","dry_cleaners","durable_goods","duty_free_stores","eating_places_restaurants","educational_services","electric_razor_stores","electrical_parts_and_equipment","electrical_services","electronics_repair_shops","electronics_stores","elementary_secondary_schools","employment_temp_agencies","equipment_rental","exterminating_services","family_clothing_stores","fast_food_restaurants","financial_institutions","fines_government_administrative_entities","fireplace_fireplace_screens_and_accessories_stores","floor_covering_stores","florists","florists_supplies_nursery_stock_and_flowers","freezer_and_locker_meat_provisioners","fuel_dealers_non_automotive","funeral_services_crematories","furniture_home_furnishings_and_equipment_stores_except_appliances","furniture_repair_refinishing","furriers_and_fur_shops","general_services","gift_card_novelty_and_souvenir_shops","glass_paint_and_wallpaper_stores","glassware_crystal_stores","golf_courses_public","government_services","grocery_stores_supermarkets","hardware_equipment_and_supplies","hardware_stores","health_and_beauty_spas","hearing_aids_sales_and_supplies","heating_plumbing_a_c","hobby_toy_and_game_shops","home_supply_warehouse_stores","hospitals","hotels_motels_and_resorts","household_appliance_stores","industrial_supplies","information_retrieval_services","insurance_default","insurance_underwriting_premiums","intra_company_purchases","jewelry_stores_watches_clocks_and_silverware_stores","landscaping_services","laundries","laundry_cleaning_services","legal_services_attorneys","luggage_and_leather_goods_stores","lumber_building_materials_stores","manual_cash_disburse","marinas_service_and_supplies","masonry_stonework_and_plaster","massage_parlors","medical_and_dental_labs","medical_dental_ophthalmic_and_hospital_equipment_and_supplies","medical_services","membership_organizations","mens_and_boys_clothing_and_accessories_stores","mens_womens_clothing_stores","metal_service_centers","miscellaneous","miscellaneous_apparel_and_accessory_shops","miscellaneous_auto_dealers","miscellaneous_business_services","miscellaneous_food_stores","miscellaneous_general_merchandise","miscellaneous_general_services","miscellaneous_home_furnishing_specialty_stores","miscellaneous_publishing_and_printing","miscellaneous_recreation_services","miscellaneous_repair_shops","miscellaneous_specialty_retail","mobile_home_dealers","motion_picture_theaters","motor_freight_carriers_and_trucking","motor_homes_dealers","motor_vehicle_supplies_and_new_parts","motorcycle_shops_and_dealers","motorcycle_shops_dealers","music_stores_musical_instruments_pianos_and_sheet_music","news_dealers_and_newsstands","non_fi_money_orders","non_fi_stored_value_card_purchase_load","nondurable_goods","nurseries_lawn_and_garden_supply_stores","nursing_personal_care","office_and_commercial_furniture","opticians_eyeglasses","optometrists_ophthalmologist","orthopedic_goods_prosthetic_devices","osteopaths","package_stores_beer_wine_and_liquor","paints_varnishes_and_supplies","parking_lots_garages","passenger_railways","pawn_shops","pet_shops_pet_food_and_supplies","petroleum_and_petroleum_products","photo_developing","photographic_photocopy_microfilm_equipment_and_supplies","photographic_studios","picture_video_production","piece_goods_notions_and_other_dry_goods","plumbing_heating_equipment_and_supplies","political_organizations","postal_services_government_only","precious_stones_and_metals_watches_and_jewelry","professional_services","public_warehousing_and_storage","quick_copy_repro_and_blueprint","railroads","real_estate_agents_and_managers_rentals","record_stores","recreational_vehicle_rentals","religious_goods_stores","religious_organizations","roofing_siding_sheet_metal","secretarial_support_services","security_brokers_dealers","service_stations","sewing_needlework_fabric_and_piece_goods_stores","shoe_repair_hat_cleaning","shoe_stores","small_appliance_repair","snowmobile_dealers","special_trade_services","specialty_cleaning","sporting_goods_stores","sporting_recreation_camps","sports_and_riding_apparel_stores","sports_clubs_fields","stamp_and_coin_stores","stationary_office_supplies_printing_and_writing_paper","stationery_stores_office_and_school_supply_stores","swimming_pools_sales","t_ui_travel_germany","tailors_alterations","tax_payments_government_agencies","tax_preparation_services","taxicabs_limousines","telecommunication_equipment_and_telephone_sales","telecommunication_services","telegraph_services","tent_and_awning_shops","testing_laboratories","theatrical_ticket_agencies","timeshares","tire_retreading_and_repair","tolls_bridge_fees","tourist_attractions_and_exhibits","towing_services","trailer_parks_campgrounds","transportation_services","travel_agencies_tour_operators","truck_stop_iteration","truck_utility_trailer_rentals","typesetting_plate_making_and_related_services","typewriter_stores","u_s_federal_government_agencies_or_departments","uniforms_commercial_clothing","used_merchandise_and_secondhand_stores","utilities","variety_stores","veterinary_services","video_amusement_game_supplies","video_game_arcades","video_tape_rental_stores","vocational_trade_schools","watch_jewelry_repair","welding_repair","wholesale_clubs","wig_and_toupee_stores","wires_money_orders","womens_accessory_and_specialty_shops","womens_ready_to_wear_stores","wrecking_and_salvage_yards"],"maxLength":5000,"type":"string"},"type":"array"},"interval":{"enum":["all_time","daily","monthly","per_authorization","weekly","yearly"],"type":"string"}},"required":["amount","interval"],"title":"spending_limits_param","type":"object"},"type":"array"},"spending_limits_currency":{"type":"string"}},"title":"authorization_controls_param_v2","type":"object"},"status":{"description":"Specifies whether to permit authorizations on this cardholder's cards. Defaults to `active`.","enum":["active","inactive"],"type":"string"},"type":{"description":"One of `individual` or `company`.","enum":["company","individual"],"type":"string","x-stripeBypassValidation":true}},"required":["billing","name","type"],"type":"object"}
```
## Security
### `basicAuth`
- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.
Basic HTTP authentication. Allowed headers-- Authorization: Basic | Authorization: Basic
### `bearerAuth`
- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.
Bearer HTTP authentication. Allowed headers-- Authorization: Bearer
## Responses
### `200`
Successful response.
### `application/json`
- Type: `object`
An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards.
Related guide: [How to create a Cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)
```json
{"description":"An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://stripe.com/docs/issuing) cards.\n\nRelated guide: [How to create a Cardholder](https://stripe.com/docs/issuing/cards#create-cardholder)","properties":{"billing":{"$ref":"#/components/schemas/issuing_cardholder_address"},"company":{"anyOf":[{"$ref":"#/components/schemas/issuing_cardholder_company"}],"description":"Additional information about a `company` cardholder.","nullable":true},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"email":{"description":"The cardholder's email address.","maxLength":5000,"nullable":true,"type":"string"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"individual":{"anyOf":[{"$ref":"#/components/schemas/issuing_cardholder_individual"}],"description":"Additional information about an `individual` cardholder.","nullable":true},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"name":{"description":"The cardholder's name. This will be printed on cards issued to them.","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["issuing.cardholder"],"type":"string"},"phone_number":{"description":"The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://stripe.com/docs/issuing/3d-secure#when-is-3d-secure-applied) for more details.","maxLength":5000,"nullable":true,"type":"string"},"requirements":{"$ref":"#/components/schemas/issuing_cardholder_requirements"},"spending_controls":{"anyOf":[{"$ref":"#/components/schemas/issuing_cardholder_authorization_controls"}],"description":"Rules that control spending across this cardholder's cards. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.","nullable":true},"status":{"description":"Specifies whether to permit authorizations on this cardholder's cards.","enum":["active","blocked","inactive"],"type":"string"},"type":{"description":"One of `individual` or `company`.","enum":["company","individual"],"type":"string","x-stripeBypassValidation":true}},"required":["billing","created","id","livemode","metadata","name","object","requirements","status","type"],"title":"IssuingCardholder","type":"object","x-expandableFields":["billing","company","individual","requirements","spending_controls"],"x-resourceId":"issuing.cardholder"}
```
### `default`
Error response.
### `application/json`
- Type: `object`
An error response from the Stripe API
```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```
## Request examples
### cURL
```shell
curl --request POST \
--url https://api.stripe.com/v1/issuing/cardholders \
--header 'content-type: application/x-www-form-urlencoded' \
--data '{
"billing": {
"address": {
"city": "string",
"country": "string",
"line1": "string",
"line2": "string",
"postal_code": "string",
"state": "string"
}
},
"company": {
"tax_id": "string"
},
"email": "string",
"expand": [
"string"
],
"individual": {
"dob": {
"day": 1,
"month": 1,
"year": 1
},
"first_name": "string",
"last_name": "string",
"verification": {
"document": {
"back": "string",
"front": "string"
}
}
},
"metadata": {},
"name": "string",
"phone_number": "string",
"spending_controls": {
"allowed_categories": [
"string"
],
"blocked_categories": [
"string"
],
"spending_limits": [
{
"amount": 1,
"categories": [
"string"
],
"interval": "string"
}
],
"spending_limits_currency": "string"
},
"status": "string",
"type": "string"
}'
```