Search POS - Points of Sale - Mercado Pago Developers
Search POS

GET

/pos
Get the information about all of your stores.
Request's parameters
external_id
string
Localization: queryExternal ID
external_store_id
string
Localization: queryExternal Store ID
store_id
string
Localization: queryStore ID
category
string
Localization: queryCategory
Response parameters
paging
object
Localization: bodypaging
results
array
Localization: bodyresults
Request
curl
curl -X GET \
    'https://api.mercadopago.com/pos?external_id=SUC001POS001&external_store_id=undefined&store_id=undefined&category=undefined' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' 
Answer
json
{
  "paging": {
    "total": 1,
    "offset": 0,
    "limit": 0
  },
  "results": [
    {
      "user_id": 446566691,
      "name": "Caja Principal",
      "category": 621102,
      "store_id": 1234567,
      "external_id": "SUC001POS001",
      "id": 1988157,
      "qr": {
        "image": "https://www.mercadopago.com/instore/merchant/qr/1988157/1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png",
        "template_document": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.pdf",
        "template_image": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png"
      },
      "date_created": "2019-06-24T13:31:56.000Z",
      "date_last_updated": "2019-08-07T21:07:26.000Z",
      "external_store_id": "SUC001"
    }
  ]
}
Errors
400bad_request
INVALID_CATEGORYThe CATEGORY must be numeric.
INVALID_STORE_IDThe STORE_ID must be numeric.
INVALID_EXTERNAL_STORE_IDThe EXTERNAL_STORE_ID must be string.
INEXISTENT_EXTERNAL_STORE_IDThe EXTERNAL STORE_ID does not refer to an existing Store.
INVALID_EXTERNAL_IDThe EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces or hyphens, or special characters.
EXTERNAL_ID_TOO_LONGThe EXTERNAL_ID must be less than 40 characters.
INVALID_LIMITThe LIMIT must be numeric.
INVALID_OFFSETThe OFFSET must be numeric.