Search stores - Physical stores - Mercado Pago Developers
Search stores

GET

/users/{user_id}/stores/search
Find all the information of the stores generated through specific filters.
Request's parameters
user_id

REQUIRED

string
Localization: pathUser Id
external_id
string
Localization: queryUnique identifier of the store defined by integrator system
Response parameters
paging
object
Localization: bodypaging
results
array
Localization: bodyresults
Request
curl
curl -X GET \
      'https://api.mercadopago.com/users/{user_id}/stores/search?external_id=SUC001' \
       -H 'Authorization: Bearer YOUR_ACCESS_TOKEN \
      
Answer
json
[
  {
    "paging": {
      "total": 1,
      "offset": 0,
      "limit": 30
    },
    "results": [
      {
        "id": 30163646,
        "name": "Sucursal Instore",
        "date_creation": "2021-04-16T14:54:28.573Z",
        "business_hours": {
          "monday": [
            {
              "open": "08:00",
              "close": "13:00"
            }
          ],
          "tuesday": [
            {
              "open": "08:00",
              "close": "18:00"
            }
          ],
          "wednesday": [
            {
              "open": "07:00",
              "close": "10:00"
            }
          ]
        },
        "location": {
          "address_line": "Caseros 3039, Belgrano, Capital Federal, Argentina",
          "reference": "3er Piso",
          "latitude": -32.8897322,
          "longitude": -68.8443275
        },
        "external_id": "SUC001"
      }
    ]
  }
]
Errors
400bad_request
INVALID_USER_IDUSER_ID must be number.
INVALID_OFFSETOFFSET must be number.
INVALID_LIMITLIMIT must be number.
INVALID_EXTERNAL_IDEXTERNAL_ID must be alphanumeric.