Retrieve merchant group - Marqeta Docs

Home

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

GET//

To retrieve a specific merchant group, send a GET request to the /merchantgroups/{token} endpoint. Include the merchant group token path parameter to specify the merchant group to return.

URL path parameters

Fields	Description
token string Required	Unique identifier of the merchant group. Allowable Values: Existing merchant group token

Response body

Fields	Description
active boolean Conditionally returned	Indicates if the merchant group is active or not. Allowable Values: `true`, `false`
created_time datetime Conditionally returned	Date and time when the resource was created, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
last_modified_time datetime Conditionally returned	Date and time when the resource was last modified, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
mids array of strings Conditionally returned	Comma-separated list of alphanumeric merchant identifiers. Allowable Values: Valid array of one or more merchant identifiers
name string Conditionally returned	Name of the merchant group. Allowable Values: 40 char max
token string Conditionally returned	Unique identifier of the merchant group. Allowable Values: Existing merchant group token

Sample response body

JSON

{
  "token": "my_merchantgroup",
  "name": "My Merchant Group",
  "mids": [
    "123456789012345",
    "345123456789012",
    "123456789012",
    "234567890123"
  ],
  "active": true,
  "created_time": "2022-05-01T13:22:07Z",
  "last_modified_time": "2022-05-01T13:32:07Z"
}