Home
Documentation
Resources
Certifications
Community
Get POS - Points of Sale - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Get point of sale

GET

https://api.mercadopago.com/pos/{id}
This endpoint allows you to find all the information about the points of sale created using specific filters.
Request's parameters
PATH
id
string

REQUIRED

Creation ID of the point of sale. When you register a point of sale, you will receive a corresponding ID. This ID can be used for various operations, including retrieving the point of sale data.
Response parameters
id
string
Creation ID of the point of sale. When you register a point of sale, you will receive a corresponding ID. This ID can be used for various operations, including retrieving the point of sale data.
qr
object
QR code automatically created to receive payments from the point of sale.
status
string
Status of the search.
date_created
string
Point of sale creation date. This field displays the date and time in ISO 8601 format, such as 2024-08-08T19:29:45.019Z.
Errors

400Error

INVALID_POS_ID

The ID of the poin of sale is invalid, it must be numeric.

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.

404Error

1

If the point of sale does not exist for an indicated ID or EXTERNAL_ID and user.

Request
curl -X GET \
    'https://api.mercadopago.com/pos/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    
Sample answer
{
  "id": 1988157,
  "qr": {
    "image": "https://www.mercadopago.com/instore/merchant/qr/2852128/c955a5618d874e998c8399e3515fed3a00b8cc0ca401448ca56e2f2e18f4ba68.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/2852128/template_c955a5618d874e998c8399e3515fed3a00b8cc0ca401448ca56e2f2e18f4ba68.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/2852128/template_c955a5618d874e998c8399e3515fed3a00b8cc0ca401448ca56e2f2e18f4ba68.png"
  },
  "status": "active",
  "date_created": "2019-09-03T13:13:54.000-04:00",
  "date_last_updated": "2019-10-25T15:16:12.000Z",
  "uuid": "c955a5618d874e998c8399e3515fed3a00b8cc0ca401448ca56e2f2e18f4ba68",
  "compatible_id": "4be87a269a7b863fd043658d2a0d7b3fa2f32334138ff651e2408d3f8191d6c9f67a4dc297e9efc70d1adfbb31f7c21c29c9059ac905a359e39114c9871afef9",
  "user_id": 329653108,
  "name": "POS001",
  "fixed_amount": false,
  "store_id": 56807753,
  "external_store_id": "SUC01",
  "external_id": "SUC001POS002",
  "site": "MLB",
  "qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/c955a5618d874e998c8399e3515fed3a43520016com.mercadolibre0128https://mpago.la/pos/28521285204000053039865802BR5924VICTOR CORREA DE ALMEIDA6008CAMPINAS62070503***6304367C"
}