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 POS - Points of Sale - Mercado Pago Developers

Intelligent search powered by OpenAI 

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-7434*********159-03141*********cee51edf8*********f94f589-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"
    }
  ]
}