Skip to main content
GET
/
{version}
/
fees
/
merchant-tier
Get Merchant Fee Tier
curl --request GET \
  --url https://api.example.com/{version}/fees/merchant-tier \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "owner_type": "<string>",
  "owner_id": 123,
  "assigned_at": "2023-11-07T05:31:56Z",
  "assigned_by": "<string>",
  "tier": {
    "id": 123,
    "name": "<string>",
    "is_default": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
version
string
required
Allowed value: "v1"

Query Parameters

​
owner_type
enum<string>
required
Available options:
USER,
MICRO_ORGANIZATION,
ORGANIZATION
​
owner_id
integer
required

Response

Successful Response

MerchantFeeResponse

​
id
integer
required
​
owner_type
string
required
​
owner_id
integer
required
​
assigned_at
string<date-time>
required
​
assigned_by
string | null
​
tier
FeeTier · object

Named platform fee plan. Only one tier may have is_default=True (unique partial index). Falls back to the default tier when no merchant-specific tier is assigned.

Last modified on June 23, 2026