Get a seller
Reads a seller by id.
Returns a seller of your account by the id the API generated at creation.
The response has the seller's data only. The marketplace accounts they connected come from List connections, with this id in the Seller-Id header.
When the response is 404
The seller does not exist, or it exists but belongs to another account. Both cases get the same answer on purpose, so nobody can discover ids of other accounts. An id that is not a UUID returns 400 VALIDATION_ERROR.
api_keyAuthorizationBearer <token>API key (mk_...)
id*stringIdentifier of the resource, as returned by the API.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidThe requested seller.
application/json- response
A seller: your customer, who connects marketplaces through you.
id*stringOpaque unique identifier of the seller, generated by the API. Use it in the /v1/sellers/{id} routes.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidname*stringDisplay name of the seller.
externalId*|Your own identifier for this seller, so you can find the record without storing ours. null when it was never set. Unique within your account.
metadata*Your own key-value data for this seller, as stored: top-level keys sent as null are not kept, and key order is not preserved. {} when there is none. Filter the listing by it with metadata[key]=value.
connections*array<>The marketplace accounts this seller has connected and working (status: active), newest first. Empty when there is none. For the full records, or other states, call GET /v1/connections with Seller-Id.
createdAt*stringWhen the seller was created, in ISO-8601 (UTC).
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdatedAt*stringWhen the seller was last changed, in ISO-8601 (UTC).
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X GET "https://example.com/v1/sellers/3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01"{ "id": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01", "name": "Acme Store", "externalId": "customer-123", "metadata": { "plan": "pro", "region": "south", "tags": [ "vip", "b2b" ] }, "connections": [ { "id": "9a1b2c3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d", "marketplace": "mercadolivre", "marketplaceDisplayName": "Mercado Livre", "status": "active" } ], "createdAt": "2026-10-06T14:30:00.000Z", "updatedAt": "2026-10-06T14:30:00.000Z"}