Skip to main content
GET
Find Account Groups by Merchant ID
Returns every account group within the authenticated organization that carries the given merchant_id. Use this endpoint to locate Yuno group records using the identifier that already exists on your side, without having to store or look up Yuno-generated group IDs.
Multiple matches and empty resultsA merchant_id is not guaranteed to be unique — more than one group can share the same value. All matching groups are returned. When no group carries the requested merchant_id, the response contains an empty data array rather than an error. Deleted groups are never included.

Authorizations

PUBLIC-API-KEY
string
header
default:<Your PUBLIC-API-KEY>
required
PRIVATE-SECRET-KEY
string
header
default:<Your PRIVATE-SECRET-KEY>
required

Query Parameters

merchant_id
string
required

The merchant-side identifier to look up. Must be an exact match.

Response

OK — zero or more matching account groups.

data
object[]

List of account groups that carry the requested merchant_id. Empty when no match is found.

pagination
object