List all active checkout styling rows for a merchant

https://api.kustom.co/config/checkout/v1/config/checkoutStyling

Returns all active value rows for this merchant across all configured countries.

Parameters

200

Example

Parameters1 field

• X-merchant-idstringoptionalin header

  Merchant identifier

200

Response11 fields

OK

• merchantIdstringoptional

  Merchant identifier.

• countrystringoptional

  ISO 3166-1 alpha-2 country code, or null for the merchant-level default.

• checkoutStylingobjectoptional

  The configured checkout styling.

  5 fields in checkoutStyling

  • surfacestringoptional

    Background colour of surfaces, as a 6-digit hex colour.

  • onSurfacestringoptional

    Primary text/content colour shown on surfaces, as a 6-digit hex colour.

  • onSurfaceMutedstringoptional

    Muted/secondary content colour shown on surfaces, as a 6-digit hex colour.

  • primarystringoptional

    Primary brand/action colour, as a 6-digit hex colour.

  • onPrimarystringoptional

    Content colour shown on top of the primary colour, as a 6-digit hex colour.

• revisioninteger · int64optional

  Monotonically increasing revision of this configuration value.

• updatedBystringoptional

  Identifier of the user or system that last updated the value.

• updatedAtstring · date-timeoptional

  Timestamp of the last update.

GET https://api.kustom.co/config/checkout/v1/config/checkoutStyling

Response200

Response 200· OK

[
  {
    "merchantId": "M123456",
    "country": "SE",
    "checkoutStyling": {
      "surface": "#FFFFFF",
      "onSurface": "#1A1A1A",
      "onSurfaceMuted": "#6B7280",
      "primary": "#2563EB",
      "onPrimary": "#FFFFFF"
    },
    "revision": 3,
    "updatedBy": "kustom-external-api",
    "updatedAt": "2026-06-22T14:30:00Z"
  }
]

16 linesCopy