Search POS - Points of Sale - Mercado Pago Developers
What are you looking for?

Do not know how to start integrating? 

Check the first steps
Search point of sale

GET

https://api.mercadopago.com/pos
This endpoint allows you to find all the information about the point of sale created using specific filters.
Request's parameters
QUERY
external_id
string
Unique identifier of the point of sale defined by integrator system.
external_store_id
string
The unique store identifier, set by the integrated system and can contain up to 60 characters.
store_id
string
Store identifier to which the point of sale belongs.
category
string
MCC code that indicates the category of the point of sale. If not specified, it remains as a generic category.
Response parameters
paging
object
Information for pagination of search results.
results
array
Results found based on the filters used for the search.
Errors

400Error

INVALID_CATEGORY

CATEGORY must be numeric.

INVALID_STORE_ID

STORE_ID must be numeric.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID must be string.

INEXISTENT_EXTERNAL_STORE_ID

The EXTERNAL STORE_ID does not refer to an existing Store.

INVALID_EXTERNAL_ID

The EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces, hyphens or special characters.

EXTERNAL_ID_TOO_LONG

The EXTERNAL_ID must be less than 40 characters.

INVALID_LIMIT

LIMIT must be numeric.

INVALID_OFFSET

OFFSET must be numeric.

Request
curl -X GET \
    'https://api.mercadopago.com/pos?external_id=SUC001POS001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    
Sample answer
{
  "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-25T15:16:12.000Z",
      "external_store_id": "SUC001"
    }
  ]
}