---
title: "Get partner status"
method: GET
path: "/v2/organizations/me/partner"
tags: ["Organizations API"]
---

# Get partner status

`GET /v2/organizations/me/partner`

## Request

- Base URL: `https://api.mollie.com`
- URL: `https://api.mollie.com/v2/organizations/me/partner`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `organizations.read`

Retrieve partnership details about the currently authenticated organization. Only relevant for so-called *partner accounts*.

> 🔑 Access with
>
> [Advanced access token with **organizations.read**](/reference/authentication)
>
> [OAuth access with **organizations.read**](/reference/authentication)

## Response `200`

The partner status object.

- object
  - `resource` string, required: Indicates the response contains a partner status object. Will always contain the string `partner` for this endpoint.
  - `partnerType` string, nullable, required: Indicates the type of partner. Will be `null` if the currently authenticated organization is not enrolled as a partner. Possible values: `oauth` `signuplink` `useragent`
  - `isCommissionPartner` boolean: Whether the current organization is receiving commissions.
  - `userAgentTokens` object[]: Array of User-Agent token objects. Present if the organization is a partner of type `useragent`, or if they were in the past.
    - `token` string: The unique User-Agent token.
    - `startsAt` string: The date from which the token is active, in ISO 8601 format.
    - `endsAt` string, nullable: The date until when the token will be active, in ISO 8601 format. Will be `null` if the token does not have an end date (yet).
  - `partnerContractSignedAt` string, nullable: The date the partner contract was signed, in ISO 8601 format. Omitted if no contract has been signed (yet).
  - `partnerContractUpdateAvailable` boolean: Whether an update to the partner contract is available and requiring the organization's agreement.
  - `partnerContractExpiresAt` string: The expiration date of the signed partner contract, in ISO 8601 format. Omitted if contract has no expiration date (yet).
  - `_links` object: 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.
    - `signuplink` object: The URL that can be used to have new organizations sign up and be automatically linked to this partner. Will be omitted if the partner is not of type `signuplink`.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `documentation` 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.

## Other responses

- `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)