Merchants

Get Merchant

Retrieves a single sub-merchant belonging to the authenticated partner.

Only merchants scoped to the authenticated partner are returned. Requests for unknown merchants or merchants outside that scope return 404.

This path currently overlaps with a legacy public merchant endpoint. To avoid ambiguous response shapes or fallback behavior, send the resolve-api-version header on every request. Use resolve-api-version: partner-v1 when you need the partner API response contract documented here.

get/merchants/{merchant_id}

Request

Path parameters

merchant_idstring required

ID of the sub-merchant under your partner account.

Response

A merchant object.

idstring

Resolve merchant identifier (lowercase alphanumeric).

For partner API create flows, ID assignment behavior is:

  • Resolve may derive a human-friendly alphanumeric candidate from merchant naming fields.
  • If the candidate collides with an existing merchant ID, Resolve generates a random lowercase alphanumeric ID.
reference_idstring nullable

Partner-supplied identifier for this merchant in your own system. null when never set.

legal_business_namestring
dba_namestring nullable
business_emailstring email
business_phonestring
entity_type'corporation' | 'llc' | 'sole_proprietorship' | 'partnership' | 'non_profit'
formation_statestring
industrystring nullable
websitestring uri nullable
underwriting_statusstring

Current underwriting lifecycle status for the merchant.

seller_amount_approvedinteger nullable

Merchant approved limit (MAL), when available.

metadataobject
created_atstring date-time
updated_atstring date-time

Example response

{
  "id": "mrc_1234567890abcdef",
  "reference_id": "partner-crm-12345",
  "legal_business_name": "Acme Supply LLC",
  "dba_name": "Acme Industrial",
  "business_address": {
    "line1": "100 Main St",
    "line2": "Suite 200",
    "city": "Austin",
    "state": "TX",
    "postal_code": "78701",
    "country": "US"
  },
  "business_email": "ops@acmesupply.com",
  "business_phone": "+15125550123",
  "entity_type": "llc",
  "formation_state": "TX",
  "industry": "Manufacturing",
  "website": "https://acmesupply.com",
  "underwriting_status": "pending",
  "seller_amount_approved": 50000,
  "active_subscription": {
    "id": "sub_1234567890abcdef",
    "tier": "trial"
  },
  "document_ingestion": {
    "requested_count": 2,
    "queued_count": 1,
    "failed_count": 1,
    "results": [
      {
        "document_id": "md_1234567890abcdef"
      }
    ]
  },
  "created_at": "2026-02-26T10:00:00.000Z",
  "updated_at": "2026-02-26T10:05:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.