--- title: "List profiles" method: GET path: "/v2/profiles" tags: ["Profiles API"] --- # List profiles `GET /v2/profiles` ## Request - Base URL: `https://api.mollie.com` - URL: `https://api.mollie.com/v2/profiles` - Auth: one of: - HTTP bearer - OAuth 2 - Authorization code: `https://my.mollie.com/oauth2/authorize` - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `profiles.read` Retrieve a list of all of your profiles. The results are paginated. > 🔑 Access with > > [Advanced access token with **profiles.read**](/reference/authentication) > > [OAuth access with **profiles.read**](/reference/authentication) ## Query parameters - `from` string - `limit` integer, nullable ## Response `200` A list of profile objects. - object - `count` integer, required: The number of items in this result set. If more items are available, a `_links.next` URL will be present in the result as well. The maximum number of items per result set is controlled by the `limit` property provided in the request. The default limit is 50 items. - `_embedded` object, required - `profiles` object[], required: An array of profile objects. - `resource` string, required: Indicates the response contains a profile object. Will always contain the string `profile` for this endpoint. - `id` string, required: The identifier uniquely referring to this profile. Example: `pfl_v9hTwCvYqw`. - `mode` string, required: Whether this entity was created in live mode or in test mode. Possible values: `live` `test` - `name` string, required: The profile's name, this will usually reflect the trade name or brand name of the profile's website or application. - `website` string, required: The URL to the profile's website or application. Only `https` or `http` URLs are allowed. No `@` signs are allowed. - `email` string, required: The email address associated with the profile's trade name or brand. If the domain contains non-ASCII characters, encode it as Punycode per [RFC 3492](https://www.rfc-editor.org/rfc/rfc3492). - `phone` string, required: The phone number associated with the profile's trade name or brand. - `description` string: The products or services offered by the profile's website or application. - `countriesOfActivity` string[]: A list of countries where you expect that the majority of the profile's customers reside, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. - `businessCategory` string, nullable, required: The industry associated with the profile's trade name or brand. Please refer to the [business category list](common-data-types#business-category) for all possible options. - `status` string, required: The profile status determines whether the profile is able to receive live payments. * `unverified`: The profile has not been verified yet and can only be used to create test payments. * `verified`: The profile has been verified and can be used to create live payments and test payments. * `blocked`: The profile is blocked and can no longer be used or changed. Possible values: `unverified` `verified` `blocked` - `review` object: Present if changes have been made that have not yet been approved by Mollie. Changes to test profiles are approved automatically, unless a switch to a live profile has been requested. The review object will therefore usually be `null` in test mode. - `status` string: The status of the requested changes. Possible values: `pending` `rejected` - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field. - `self` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `dashboard` object: Link to the profile in the Mollie dashboard. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `chargebacks` object: The API resource URL of the chargebacks that belong to this profile. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `methods` object: The API resource URL of the methods that are enabled for this profile. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `payments` object: The API resource URL of the payments that belong to this profile. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `refunds` object: The API resource URL of the refunds that belong to this profile. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `checkoutPreviewUrl` object: The hosted checkout preview URL. You need to be logged in to access this page. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `_links` object, required: Links to help navigate through the lists of items. Every URL object will contain an `href` and a `type` field. - `self` object, required: The URL to the current set of items. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. - `previous` object, nullable, required: The previous set of items, if available. - `href` string: The actual URL string. - `type` string: The content type of the page or endpoint the URL points to. - `next` object, nullable, required: The next set of items, if available. - `href` string: The actual URL string. - `type` string: The content type of the page or endpoint the URL points to. - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field. - `href` string, required: The actual URL string. - `type` string, required: The content type of the page or endpoint the URL points to. ## Other responses - `400`: The request contains issues. For example, if the specified `from` value is not a valid ID. - `429`: Rate Limit has been reached. --- [API](https://skmtc.dev/mollie/apis/mollie-connect.md) - [All operations](https://skmtc.dev/mollie/apis/mollie-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/mollie-connect/revisions/65271e79a786?raw)