admin_terminals_operations_get

curl --request GET \
  --url https://checkout.dintero.com/v1/admin/terminals/operations \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://checkout.dintero.com/v1/admin/terminals/operations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://checkout.dintero.com/v1/admin/terminals/operations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "terminal_id": "<string>",
    "operation": "end_of_day",
    "status": "PENDING",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "updated_by": "<string>",
    "account_id": "<string>",
    "parameters": {
      "operator_id": "<string>"
    },
    "result": {
      "result": "accepted",
      "batchId": "<string>",
      "startOfDay": "<string>",
      "lastEndOfDay": "<string>",
      "purchasesCount": "<string>",
      "purchasesAmount": "<string>",
      "reversalsCount": "<string>",
      "reversalsAmount": "<string>",
      "saleAmount": "<string>",
      "tipAmount": "<string>"
    }
  }
]

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

terminals

List terminal operation results

List administrative operations sent to any of the account’s terminals, most recently created first. Filter to a single terminal with terminal_id, or a single operation with operation_id.

Poll this endpoint to see how a command finished: an operation is created as PENDING and reaches COMPLETED, FAILED or TIMEOUT once the terminal answers or the timeout window passes. The result of a completed operation is specific to the operation that was run.

scopes:

admin:checkout
read:checkout:/admin/terminals

GET

https://checkout.dintero.com/v1

admin

terminals

operations

admin_terminals_operations_get

curl --request GET \
  --url https://checkout.dintero.com/v1/admin/terminals/operations \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://checkout.dintero.com/v1/admin/terminals/operations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://checkout.dintero.com/v1/admin/terminals/operations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "terminal_id": "<string>",
    "operation": "end_of_day",
    "status": "PENDING",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "updated_by": "<string>",
    "account_id": "<string>",
    "parameters": {
      "operator_id": "<string>"
    },
    "result": {
      "result": "accepted",
      "batchId": "<string>",
      "startOfDay": "<string>",
      "lastEndOfDay": "<string>",
      "purchasesCount": "<string>",
      "purchasesAmount": "<string>",
      "reversalsCount": "<string>",
      "reversalsAmount": "<string>",
      "saleAmount": "<string>",
      "tipAmount": "<string>"
    }
  }
]

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication (token authentication) should be used for accessing the API.

Use Get Token to get an access token for client credentials. Pass the token in the request header:

Authorization: Bearer {access_token}

where the access_token is JSON Web Tokens (JWT).

Query Parameters

terminal_id

string

Filter operations by terminal identifier.

operation_id

string<uuid>

Filter by operation identifier.

limit

integer

default:100

Maximum number of operations to return.

starting_after

string<uuid>

Return operations created before the operation with this identifier, for paging through the list.

Response

Terminal operations

end_of_day
send_logs
check_update
open_menu
poll_terminal

Terminal operation. The shape depends on the operation field. When present, the fields inside result are camelCase, unlike the rest of the operation.

string<uuid>

required

Unique identifier for the terminal operation.

terminal_id

string

required

Identifier of the terminal the operation was sent to.

operation

enum<string>

required

The command that was sent to the terminal.

end_of_day: close the terminal's current batch and settle it with the acquirer. Run once per trading day, after the last payment.
send_logs: have the terminal upload its log files for troubleshooting. The logs are not returned through this API.
check_update: have the terminal check for a software update and install one if available. May reboot the terminal.
open_menu: open the settings menu on the terminal's own screen for an operator standing at the device. The terminal cannot take payments while the menu is open.
poll_terminal: ping the terminal to see whether it is online and responding. Has no effect on the device.

Available options:

end_of_day

status

enum<string>

required

Status of the terminal operation.

PENDING: Operation has been dispatched to the terminal and is awaiting a response.
COMPLETED: Terminal has responded and the operation finished successfully.
FAILED: Terminal responded but reported a failure.
TIMEOUT: No response was received from the terminal within the timeout window. A new operation can be dispatched.

Which statuses an operation can reach depends on the operation. open_menu and poll_terminal are never reported as FAILED, since the terminal does not report a failure for them - an unreachable terminal ends those operations as TIMEOUT. end_of_day, send_logs and check_update can be FAILED when the terminal answers but reports a problem; the result of the operation says what it was.

Available options:

PENDING,

COMPLETED,

FAILED,

TIMEOUT

created_at

string<date-time>

required

When the operation was created.

created_by

string

required

Identity of the user or system that created the operation.

updated_at

string<date-time>

required

When the operation was last updated.

updated_by

string

required

Identity of the user or system that last updated the operation.

account_id

string

Account identifier the operation belongs to.

parameters

object

Parameters of the operation.

Show child attributes

result

object

Batch totals as reported by the terminal. Present when status is COMPLETED or FAILED - on FAILED, result says why the day was not accepted.

The counts and amounts are the strings the terminal reported rather than numbers. All fields except result are only present if the terminal included them.

Show child attributes

Last modified on September 28, 2026