Events

GET

Get all events for an entity

Path parameters

entityIdstringRequired

Entity ID or Entity ForeignID

Query parameters

startDatedatetimeOptional

Start date filter. If not provided, events from the start of time will be returned.

endDatedatetimeOptional

End date filter. If not provided, events to the end of time will be returned.

Response

This endpoint returns an object.

datalist of objects

countinteger

GET

1 curl https://api.mercoa.com/entity/ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced/events \
2      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "data": [
3     {
4       "webhookIds": [
5         "webhook_12345"
6       ],
7       "data": {
8         "id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
9         "name": "Acme Inc.",
10         "email": "customer@acme.com",
11         "isCustomer": true,
12         "accountType": "business",
13         "profile": {
14           "business": {
15             "legalBusinessName": "Acme Inc.",
16             "taxIDProvided": true,
17             "email": "customer@acme.com",
18             "businessType": "llc",
19             "phone": {
20               "countryCode": "1",
21               "number": "4155551234"
22             },
23             "address": {
24               "addressLine1": "123 Main St",
25               "city": "San Francisco",
26               "stateOrProvince": "CA",
27               "postalCode": "94105",
28               "addressLine2": "Unit 1",
29               "country": "US"
30             },
31             "ownersProvided": true
32           }
33         },
34         "status": "verified",
35         "acceptedTos": true,
36         "isPayor": true,
37         "isPayee": false,
38         "isNetworkPayor": false,
39         "isNetworkPayee": false,
40         "createdAt": "2024-01-01T00:00:00Z",
41         "updatedAt": "2024-01-02T00:00:00Z",
42         "foreignId": "MY-DB-ID-12345"
43       },
44       "createdAt": "2024-01-01T00:00:00.000Z",
45       "userId": "user_e24fc81c-c5ee-47e8-af42-4fe29d895506"
46     }
47   ],
48   "count": 1
49 }

Built with

1	curl https://api.mercoa.com/entity/ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced/events \
2	-H "Authorization: Bearer <token>"

1	{
2	"data": [
3	{
4	"webhookIds": [
5	"webhook_12345"
6	],
7	"data": {
8	"id": "ent_8545a84e-a45f-41bf-bdf1-33b42a55812c",
9	"name": "Acme Inc.",
10	"email": "customer@acme.com",
11	"isCustomer": true,
12	"accountType": "business",
13	"profile": {
14	"business": {
15	"legalBusinessName": "Acme Inc.",
16	"taxIDProvided": true,
17	"email": "customer@acme.com",
18	"businessType": "llc",
19	"phone": {
20	"countryCode": "1",
21	"number": "4155551234"
22	},
23	"address": {
24	"addressLine1": "123 Main St",
25	"city": "San Francisco",
26	"stateOrProvince": "CA",
27	"postalCode": "94105",
28	"addressLine2": "Unit 1",
29	"country": "US"
30	},
31	"ownersProvided": true
32	}
33	},
34	"status": "verified",
35	"acceptedTos": true,
36	"isPayor": true,
37	"isPayee": false,
38	"isNetworkPayor": false,
39	"isNetworkPayee": false,
40	"createdAt": "2024-01-01T00:00:00Z",
41	"updatedAt": "2024-01-02T00:00:00Z",
42	"foreignId": "MY-DB-ID-12345"
43	},
44	"createdAt": "2024-01-01T00:00:00.000Z",
45	"userId": "user_e24fc81c-c5ee-47e8-af42-4fe29d895506"
46	}
47	],
48	"count": 1
49	}