List connections
Lists the connections of a seller, one page at a time.
Returns the connections of a seller, from the newest to the oldest. The seller goes in the Seller-Id header.
curl "$BACKEND_URL/v1/connections?status=active&page=1&pageSize=20" \
-H "Authorization: Bearer mk_your_api_key" \
-H "Seller-Id: $SELLER_ID"Use status to get only one state (for example, active). Pagination works as in List sellers: read pagination.hasNext and ask for page + 1.
Common errors
400 VALIDATION_ERRORwithdetails.header = "Seller-Id": the header is missing or is not a UUID.404 NOT_FOUND: the seller inSeller-Iddoes not exist or belongs to another account.
api_keyAuthorizationBearer <token>API key (mk_...)
page?integerPage number, starting at 1. Defaults to 1. A page beyond pagination.totalPages is not an error: it returns empty data.
1 <= value <= 90071992547409911pageSize?integerItems per page, from 1 to 100. Defaults to 20.
1 <= value <= 10020status?stringOnly connections in this state. Omit it to get every state.
"active""revoked""error"Seller-Id*stringThe id of the seller the request is about, as POST /v1/sellers returned it. Not a secret: the API key authenticates, and this header only picks the seller.
uuidOne page of connections of the seller, newest first. pagination carries the totals; a page beyond pagination.totalPages returns empty data, not 404.
application/json- response
One page of connections of a seller.
data*array<>The connections of this page, newest first.
pagination*Where this page sits in the whole listing: the totals and whether there are pages before and after it.
curl -X GET "https://example.com/v1/connections" \ -H "Seller-Id: 3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01"{ "data": [ { "id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "sellerId": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01", "marketplace": "mercadolivre", "app": "platform", "externalAccountId": "123456789", "externalShopId": null, "displayName": "ACME_STORE", "status": "active", "scopes": [ "offline_access", "read", "write" ], "tokenExpiresAt": "2026-10-06T20:32:00.000Z", "authorizationExpiresAt": null, "revokedAt": null, "revokedReason": null, "createdAt": "2026-10-06T14:32:00.000Z", "updatedAt": "2026-10-06T14:32:00.000Z" } ], "pagination": { "page": 1, "pageSize": 20, "totalItems": 1, "totalPages": 1, "hasNext": false, "hasPrev": false }}