# Adds the Stripe profiles API to represent public business identities on Stripe ## What’s new Adds the [Business Profiles](https://docs.stripe.com/api/v2/network/business-profiles.md?api-version=2026-04-22.preview) API for retrieving information about business profiles on the Stripe network. Use the [me](https://docs.stripe.com/api/v2/network/business-profiles/retrieve-network-business-profile-me.md?api-version=2026-04-22.preview) method to retrieve your own Stripe profile, or the [retrieve](https://docs.stripe.com/api/v2/network/business-profiles/retrieve.md?api-version=2026-04-22.preview) method to look up another business by their network ID. Businesses on the Stripe network have a profile with a network ID (`profile_1234`), a human-readable profile handle (@example), and business details like display name and URL. ## Impact You can now retrieve information about business profiles on the Stripe network. Network IDs are stable identifiers that never change, even if a business updates their profile handle. Always use network IDs when referencing profiles across other Stripe APIs. Business profiles are needed when using the [Shared Payment Token (SPT)](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens.md) and [Orchestrated Commerce Agreement (OCA)](https://docs.stripe.com/api/v2/orchestrated_commerce/agreements.md?api-version=2026-04-22.preview) APIs, where agents and sellers exchange network IDs to establish data-sharing permissions. ## Changes #### REST API | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------- | | | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Endpoints | Change | Resource | | ---------------- | ------ | ---------------------------------------------------------------------------------------------- | | `me`, `retrieve` | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### Ruby | | Change | Resource | | | ------ | ------------------------------------------------------------------------------------------------ | | | Added | [V2::Network::BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ---------------- | ------ | ------------------------------------------------------------------------------------------------ | | `me`, `retrieve` | Added | [V2::Network::BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### Python | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------- | | | Added | [v2.network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ---------------- | ------ | ---------------------------------------------------------------------------------------------- | | `me`, `retrieve` | Added | [v2.network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### PHP | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------- | | | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ---------------- | ------ | ---------------------------------------------------------------------------------------------- | | `me`, `retrieve` | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### Java | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------- | | | Added | [v2.network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ---------------- | ------ | ---------------------------------------------------------------------------------------------- | | `me`, `retrieve` | Added | [v2.network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### Node.js | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------- | | | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ---------------- | ------ | ---------------------------------------------------------------------------------------------- | | `me`, `retrieve` | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### Go | | Change | Resource | | | ------ | -------------------------------------------------------------------------------------------- | | | Added | [V2NetworkBusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ----------- | ------ | -------------------------------------------------------------------------------------------- | | `Get`, `Me` | Added | [V2NetworkBusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | #### .NET | | Change | Resource | | | ------ | ---------------------------------------------------------------------------------------------- | | | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | | Methods | Change | Resource | | ----------- | ------ | ---------------------------------------------------------------------------------------------- | | `Get`, `Me` | Added | [V2.Network.BusinessProfile](/api/v2/network/business-profiles?api-version=2026-04-22.preview) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. If you use an SDK, upgrade to the corresponding SDK version for this API version. - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-04-22.preview` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).