Search stores - Physical stores - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Search stores

GET

https://api.mercadopago.com/users/{user_id}/stores/search
Find all the information of the stores generated through specific filters.
Request's parameters
PATH
user_id
string

REQUIRED

User Id
QUERY
external_id
string
Unique identifier of the store defined by integrator system
Response parameters
paging
object
paging
results
array
results
Errors

400Error

INVALID_USER_ID

USER_ID must be number.

INVALID_OFFSET

OFFSET must be number.

INVALID_LIMIT

LIMIT must be number.

INVALID_EXTERNAL_ID

EXTERNAL_ID must be alphanumeric.

Request
curl -X GET \
    'https://api.mercadopago.com/users/{user_id}/stores/search?external_id=SUC001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
    
Sample answer
[
  {
    "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"
      }
    ]
  }
]