Search point of salehttps://api.mercadopago.com/pos
This endpoint allows you to find all the information about the point of sale created using specific filters
GET
Request parameters
Header
Authorization
Access Token obtained through the developer panel. Must be sent in all requests.string
REQUIRED
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.
Provide valid data in the request parameters before executing.
Request
curl -X GET \
'https://api.mercadopago.com/pos?external_id=SUC001POS001'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
Response
{
"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"
}
]
}