This endpoint allows to search the points of sale associated with the Access Token user, using various filters and pagination information. In case of success, the request will return a response with status 200.
GET
REQUIRED
external_store_id in the same request.store_id in the same request.400Bad request
conflicting_store_filters
The store_id and external_store_id filters cannot be sent simultaneously in the same request. Use only one of them.
invalid_query_param
One or more query parameters contain an invalid value. Verify that category is a valid integer, offset is a non-negative integer, and limit is an integer between 1 and 30.
invalid_store_id
The store_id filter value is not a valid number. Verify that the value sent is a valid integer.
401Unauthorized
unauthorized
The value sent as Access Token is incorrect or missing. Please check and try again with a valid Access Token.
500Internal server error
internal_server_error
An unexpected error occurred on the server. This is a transient failure not related to the request data. Please try again after a few moments.
curl -X GET \
'https://api.mercadopago.com/v2/pos?external_id=POS_EXT_01&store_id=987654&external_store_id=STORE_EXT_01&category=473000&limit=30'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
{
"paging": {
"total": 150,
"offset": 0,
"limit": 30
},
"data": [
{
"id": 1234567,
"name": "POS-001",
"status": "active",
"date_created": "2024-01-15T10:30:00Z",
"date_last_updated": "2024-03-01T08:00:00Z",
"user_id": 123456,
"store_id": "987654",
"external_id": "SUC001POS001",
"config": {
"qr": {
"operating_mode": "pdv"
}
},
"qr_response": {
"uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
"image": "https://www.mercadopago.com/instore/merchant/qr/1234567/abc123.png",
"template_document": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.pdf",
"template_image": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.png",
"qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/abc123"
}
}
]
}