Get All Groups

GET

Get all entity groups. If using a JWT, will return all groups the entity is part of. If using an API key, will return all groups for the organization.

Query parameters

limitintegerOptional

The maximum number of results to return. Defaults to 1. Max is 10.

startingAfterstringOptional

Response

This endpoint returns an object

countinteger

hasMoreboolean

datalist of objects

GET

1 curl https://api.mercoa.com/entityGroups \
2      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "count": 3,
3   "hasMore": false,
4   "data": [
5     {
6       "id": "entg_a3582b70-fd04-4888-9185-a640ae9048be",
7       "entities": [
8         {
9           "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
10           "name": "Acme Inc.",
11           "email": "customer@acme.com",
12           "isCustomer": true,
13           "accountType": "business",
14           "profile": {
15             "business": {
16               "legalBusinessName": "Acme Inc.",
17               "taxIDProvided": true,
18               "email": "customer@acme.com",
19               "businessType": "llc",
20               "phone": {
21                 "countryCode": "1",
22                 "number": "4155551234"
23               },
24               "address": {
25                 "addressLine1": "123 Main St",
26                 "city": "San Francisco",
27                 "stateOrProvince": "CA",
28                 "postalCode": "94105",
29                 "addressLine2": "Unit 1",
30                 "country": "US"
31               },
32               "ownersProvided": true
33             }
34           },
35           "status": "verified",
36           "acceptedTos": true,
37           "isPayor": true,
38           "isPayee": false,
39           "isNetworkPayor": false,
40           "isNetworkPayee": false,
41           "createdAt": "2024-01-01T00:00:00Z",
42           "updatedAt": "2024-01-02T00:00:00Z",
43           "foreignId": "MY-DB-ID-12345"
44         },
45         {
46           "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
47           "name": "Big Box Store",
48           "email": "vendor@bigboxstore.com",
49           "isCustomer": false,
50           "accountType": "business",
51           "profile": {
52             "business": {
53               "legalBusinessName": "Big Box Store",
54               "taxIDProvided": false,
55               "email": "vendor@bigboxstore.com",
56               "businessType": "publicCorporation",
57               "ownersProvided": false
58             }
59           },
60           "status": "unverified",
61           "acceptedTos": false,
62           "isPayor": false,
63           "isPayee": true,
64           "isNetworkPayor": false,
65           "isNetworkPayee": false,
66           "createdAt": "2024-01-01T00:00:00Z",
67           "updatedAt": "2024-01-02T00:00:00Z",
68           "foreignId": "MY-DB-ID-90909"
69         }
70       ],
71       "foreignId": "your-group-id",
72       "name": "AcmeConglomerate",
73       "emailToName": "acmegroup"
74     }
75   ]
76 }

Built with

1	curl https://api.mercoa.com/entityGroups \
2	-H "Authorization: Bearer <token>"

1	{
2	"count": 3,
3	"hasMore": false,
4	"data": [
5	{
6	"id": "entg_a3582b70-fd04-4888-9185-a640ae9048be",
7	"entities": [
8	{
9	"id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
10	"name": "Acme Inc.",
11	"email": "customer@acme.com",
12	"isCustomer": true,
13	"accountType": "business",
14	"profile": {
15	"business": {
16	"legalBusinessName": "Acme Inc.",
17	"taxIDProvided": true,
18	"email": "customer@acme.com",
19	"businessType": "llc",
20	"phone": {
21	"countryCode": "1",
22	"number": "4155551234"
23	},
24	"address": {
25	"addressLine1": "123 Main St",
26	"city": "San Francisco",
27	"stateOrProvince": "CA",
28	"postalCode": "94105",
29	"addressLine2": "Unit 1",
30	"country": "US"
31	},
32	"ownersProvided": true
33	}
34	},
35	"status": "verified",
36	"acceptedTos": true,
37	"isPayor": true,
38	"isPayee": false,
39	"isNetworkPayor": false,
40	"isNetworkPayee": false,
41	"createdAt": "2024-01-01T00:00:00Z",
42	"updatedAt": "2024-01-02T00:00:00Z",
43	"foreignId": "MY-DB-ID-12345"
44	},
45	{
46	"id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
47	"name": "Big Box Store",
48	"email": "vendor@bigboxstore.com",
49	"isCustomer": false,
50	"accountType": "business",
51	"profile": {
52	"business": {
53	"legalBusinessName": "Big Box Store",
54	"taxIDProvided": false,
55	"email": "vendor@bigboxstore.com",
56	"businessType": "publicCorporation",
57	"ownersProvided": false
58	}
59	},
60	"status": "unverified",
61	"acceptedTos": false,
62	"isPayor": false,
63	"isPayee": true,
64	"isNetworkPayor": false,
65	"isNetworkPayee": false,
66	"createdAt": "2024-01-01T00:00:00Z",
67	"updatedAt": "2024-01-02T00:00:00Z",
68	"foreignId": "MY-DB-ID-90909"
69	}
70	],
71	"foreignId": "your-group-id",
72	"name": "AcmeConglomerate",
73	"emailToName": "acmegroup"
74	}
75	]
76	}