Obtener lista de terminals - Terminals - Mercado Pago Developers
Obtener lista de terminals

Este endpoint te permite obtener una listado de las terminals Point activas en tu cuenta, con la información correspondiente a su respectiva caja, sucursal y modo de operación. El terminal disponible para ejecutar esta solicitud será el NEWLAND_N950. En caso de éxito, la solicitud devolverá una respuesta con el estado 200

GET

https://api.mercadopago.com/terminals/v1/list
Request parameters
Query
limit
integer
Límite de paginación. Especifica el número máximo de registros que deseas obtener en la respuesta. Debe ser un valor numérico, mayor o igual a 1 y menor o igual a 50. El valor por defecto es 50.
offset
integer
Offset de paginación. Determina el punto de inicio desde el cual se deben obtener los registros. Debe ser un valor numérico mayor o igual a cero (0). Su valor por defecto es cero (0).
store_id
string
Es el identificador de la sucursal, que se corresponde con el parámetro "id" obtenido en la respuesta a su creación. Deberás enviarlo sólo si quieres filtrar las terminals disponibles por sucursal.
pos_id
integer
Es el identificador de la caja, que se corresponde con el parámetro "id" obtenido en la respuesta a su creación. Deberás enviarlo sólo si quieres filtrar las terminals disponibles por caja.
Response parameters
data
object
Este nodo contiene el listado de terminals Point asociadas a tu cuenta de Mercado Pago disponibles.
paging
object
Errors

401Error.

unauthorized

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.

500Error.

internal_error

Error interno. Por favor, revisa el mensaje retornado e intenta enviar la solicitud nuevamente.

Request
curl -X GET \
    'https://api.mercadopago.com/terminals/v1/list?limit=50&offset=1&store_id=1235456678&pos_id=1235456678'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-7*********635832-03*********2ffa6c013*********0a90fa2cd*********120' \
    
Response
{
  "data": {
    "terminals": [
      {
        "id": "NEWLAND_N950__N950NCB801293324",
        "pos_id": 47792476,
        "store_id": "47792478",
        "external_pos_id": "SUC0101POS",
        "operating_mode": "PDV | STANDALONE | UNDEFINED"
      }
    ]
  },
  "paging": {
    "total": 1,
    "offset": 0,
    "limit": 50
  }
}