Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Search stores - Physical stores - Mercado Pago Developers

Intelligent search powered by OpenAI 

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-4599*********755-11221*********d497ae962*********ecf8d85-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"
      }
    ]
  }
]