# Get point of sale This endpoint allows to get the configuration of a specific point of sale identified by its ID. The point of sale must belong to the Access Token user. In case of success, the request will return a response with status 200. **GET** `/v2/pos/{pos_id}` ## Request parameters ### Path - `pos_id` (string, required) It is the numeric identifier of the point of sale, automatically assigned by Mercado Pago at creation time through the endpoint [POST /v2/pos](/developers/en/reference/in-person-payments/point/pos/create-pos/post). Must be a valid `integer` greater than or equal to 0. ## Response parameters - `id` (integer, optional) It is the unique numeric identifier of the point of sale, automatically generated by Mercado Pago at creation time. When you register a point of sale, you will receive a corresponding ID. This ID can be used for various operations, including retrieving, updating, or deleting the point of sale. - `name` (string, optional) It is the name of the point of sale, defined by the integrator at creation time. - `status` (string, optional) It indicates the current status of the point of sale. Possible values: `active` (the point of sale is enabled and available to receive payments) and `inactive` (the point of sale is disabled and cannot receive payments). Possible enum values: - `active` - `inactive` - `date_created` (string, optional) Date and time the point of sale was created in ISO 8601 format. For example, 2024-08-08T19:29:45.019Z. - `date_last_updated` (string, optional) Date and time of the last update to the point of sale data in ISO 8601 format. For example, 2024-08-08T19:29:45.019Z. - `user_id` (integer, optional) The `user_id` corresponds to the `collector_id`. It refers to the identifier of the Mercado Pago account that receives the money from sales, that is, the account responsible for collecting the funds. - `external_id` (string, optional) It is the external identifier of the point of sale, defined by the integrator system at creation time. - `qr_response` (object, optional) QR code data automatically generated and associated with the point of sale at creation time. - `qr_response.uuid` (string, optional) It is the unique identifier of the QR code associated with this point of sale, represented as a 64-character hexadecimal `string` (SHA-256 hash). - `qr_response.image` (string, optional) It is the URL of the QR code image to be printed or displayed for receiving payments. - `qr_response.template_document` (string, optional) It is the URL of the PDF template document containing the QR code, ready for printing. - `qr_response.template_image` (string, optional) It is the URL of the image template containing the QR code, ready for printing. - `qr_response.qr_code` (string, optional) It is the raw QR code `string` that can be encoded into a QR image by the integrator system. - `config` (object, optional) Point of sale configuration returned by the API. - `config.qr` (object, optional) QR code configuration for the point of sale. - `config.qr.operating_mode` (string, optional) Operating mode configured for the point of sale. Possible values: `pdv`, `unattended`, `self_service`, `standalone`. Possible enum values: - `pdv` - `unattended` - `self_service` - `standalone` - `config.qr.category` (integer, optional) MCC category code assigned to the point of sale, when applicable. ## Errors | Status | Error | Description | | ------- | ------- | ----------- | | 400 | resource_bad_request_error | The `pos_id` provided in the path is not a valid `integer` or is negative. Verify that the value is a non-negative base-10 `integer`. | | 400 | bad_request | The `pos_id` provided in the path is not a valid `integer` or does not belong to the Access Token user. Verify that the value is a non-negative base-10 `integer` and that the point of sale is associated with your account. | | 401 | unauthorized | The value sent as Access Token is incorrect or missing. Please check and try again with a valid Access Token. | | 404 | pos_not_found | No point of sale was found for the provided `pos_id` and the Access Token user. Verify that the ID is correct and belongs to your account. | | 500 | 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. | ## Request example ### cURL ```bash curl -X GET \ 'https://api.mercadopago.com/v2/pos/{pos_id}' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' ``` ## Response example ```json { "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, "external_id": "SUC001POS001", "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" }, "config": { "qr": { "operating_mode": "pdv", "category": 0 } } } ```