Search stores - Physical stores - Mercado Pago Developers
What 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
This endpoint allows you to find all the information about created stores using specific filters. A status 200 indicates that the request has been successfully processed.
Request's parameters
PATH
user_id
string

REQUIRED

The user_id corresponds to the collector_id. It refers to the user_id of the Mercado Pago account that receives the money from sales, that is, the account responsible for collecting the funds.
QUERY
external_id
string
unique store identifier, set by the integrated system and can contain up to 60 characters.
Response parameters
paging
object
Paging: This object contains the response parameters used to control the presentation of data in pages.
results
array
Results.
Errors

400Error

INVALID_USER_ID

user_id must be a number - If this error appears, ensure that the user_id provided is strictly numeric.

INVALID_OFFSET

offset must be a number - If you encounter this error, verify that the offset is a numeric value.

INVALID_LIMIT

limit must be a number - In case this error occurs, please check that the limit is specified as a numeric value.

INVALID_EXTERNAL_ID

external_id must be alphanumeric - If this error appears, ensure the external_id contains only letters and numbers.

403Error

Forbidden

`You don't have permission to access the URL on this server.` If you receive this message, check the user_id field and ensure it is correct and numeric only.

404Error

store_not_found

`Store not found.` Check if the search parameter used to locate the store is valid and make a new request.

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-7719*********832-03141*********ec9309854*********f1e54b5-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": "09:00",
              "close": "18:00"
            }
          ],
          "wednesday": [
            {
              "open": "07:00",
              "close": "18:00"
            }
          ]
        },
        "location": {
          "address_line": "Example Street Name, 3039, Buenos Aires, Buenos Aires.",
          "reference": "3er Piso",
          "latitude": -32.8897322,
          "longitude": -68.8443275
        },
        "external_id": "SUC001"
      }
    ]
  }
]