Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Get terminals list - In person payments - Mercado Pago Developers

Intelligent search powered by OpenAI 

Get list of terminals

GET

https://api.mercadopago.com/terminals/v1/list
This endpoint allows you to obtain a list of the Point terminals associated with your account, with the information corresponding to their respective point of sale, store, and operating mode. In case of success, the request will return a response with status 200.
Request's parameters
QUERY
limit
integer
Pagination limit. This parameter specifies the maximum number of records you want to get in the response. It must be a numeric value, greater than or equal to 1 and less than or equal to 50. The default value is 50.
offset
integer
Pagination offset. This parameter determines the starting point from which the records should be obtained. It must be a numerical value greater than or equal to zero (0). Its default value is zero (0).
Response parameters
data
object
This node contains a list of available Point terminals associated with your Mercado Pago account.
paging
object
Errors

424Error.

internal_error

Internal error. Please check the returned message and try submitting your request again.

502Error.

internal_error

Internal error. Please check the returned message and try submitting your request again.

504Error.

internal_error

Internal error. Please check the returned message and try submitting your request again.

Request
curl -X GET \
    'https://api.mercadopago.com/terminals/v1/list?limit=50&offset=1'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    
Sample answer
{
  "data": {
    "terminals": [
      {
        "id": "PAX_A910__SMARTPOS1234345545",
        "pos_id": 47792476,
        "store_id": 47792478,
        "external_pos_id": "SUC0101POS",
        "operating_mode": "PDV | STANDALONE | UNDEFINED"
      }
    ]
  },
  "paging": {
    "total": 1,
    "offset": 0,
    "limit": 50
  }
}