Intelligent search powered by OpenAI
Search point of sale
GET
Products that use it:
Request's parameters
QUERY
external_id
Unique identifier of the point of sale defined by integrator system.string
external_store_id
The unique store identifier, set by the integrated system and can contain up to 60 characters.string
store_id
Store identifier to which the point of sale belongs.string
category
MCC code that indicates the category of the point of sale. If not specified, it remains as a generic category.string
Response parameters
paging
Information for pagination of search results.object
results
Results found based on the filters used for the search.array
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-3322*********190-03031*********46528954c*********0339910-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"
}
]
}