Terminals

Retrieve a all terminals of this company

get

https://api.brouwervos.nlhttps://staging.api.brouwervos.nl

/v1/companies/{companyId}/terminals

Get details of all terminals for a given company.

Authorizations

bearerAuth

Path parameters

companyIdstringRequired

Unique identifier of the company.

terminalIdstringRequired

Unique identifier of the terminal.

Responses

200

Detailed information about the terminal.

application/json

idstringOptional

Unique identifier of the terminal.

namestringOptional

Name or descriptive identifier of the terminal.

modelstringOptional

Model number or type of the terminal.

currencystring · enumOptionalPossible values:

serialstringOptional

Serial number of the terminal.

activebooleanOptional

Indicates whether the terminal is currently active.

createdstring · date-timeOptional

Timestamp indicating when the terminal was created.

404

Company not found.

get

/v1/companies/{companyId}/terminals

HTTPcURLJavaScriptPython

GET /v1/companies/{companyId}/terminals HTTP/1.1
Host: api.brouwervos.nl
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "model": "text",
    "address": {
      "premise": "text",
      "building": "text",
      "sub_premise": "text",
      "address2": "text",
      "postal_code": "text",
      "thoroughfare": "text",
      "locality": "text",
      "state": "text",
      "country": "text"
    },
    "currency": "AED",
    "serial": "text",
    "active": true,
    "created": "2026-03-24T19:37:57.018Z"
  }
]

Retrieve a Specific Terminal

get

https://api.brouwervos.nlhttps://staging.api.brouwervos.nl

/v1/companies/{companyId}/terminals/{terminalId}

Get details of a specific terminal for a given company under the authenticated partner.

Authorizations

bearerAuth

Path parameters

companyIdstringRequired

Unique identifier of the company.

terminalIdstringRequired

Unique identifier of the terminal.

Responses

200

Detailed information about the terminal.

application/json

idstringOptional

Unique identifier of the terminal.

namestringOptional

Name or descriptive identifier of the terminal.

modelstringOptional

Model number or type of the terminal.

currencystring · enumOptionalPossible values:

serialstringOptional

Serial number of the terminal.

activebooleanOptional

Indicates whether the terminal is currently active.

createdstring · date-timeOptional

Timestamp indicating when the terminal was created.

404

Terminal or company not found.

get

/v1/companies/{companyId}/terminals/{terminalId}

HTTPcURLJavaScriptPython

GET /v1/companies/{companyId}/terminals/{terminalId} HTTP/1.1
Host: api.brouwervos.nl
Accept: */*

{
  "id": "text",
  "name": "text",
  "model": "text",
  "address": {
    "premise": "text",
    "building": "text",
    "sub_premise": "text",
    "address2": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "text",
    "state": "text",
    "country": "text"
  },
  "currency": "AED",
  "serial": "text",
  "active": true,
  "created": "2026-03-24T19:37:57.018Z"
}

Create a access token for you to use internally with communication with the terminal

post

https://api.brouwervos.nlhttps://staging.api.brouwervos.nl

/v1/companies/{companyId}/terminals/{terminalId}/access_token

Get details of a specific terminal for a given company under the authenticated partner.

Authorizations

bearerAuth

Path parameters

companyIdstringRequired

Unique identifier of the company.

terminalIdstringRequired

Unique identifier of the terminal.

Responses

200

Detailed information about the terminal.

application/json

access_tokenstringOptional

404

Terminal or company not found.

post

/v1/companies/{companyId}/terminals/{terminalId}/access_token

HTTPcURLJavaScriptPython

POST /v1/companies/{companyId}/terminals/{terminalId}/access_token HTTP/1.1
Host: api.brouwervos.nl
Accept: */*

{
  "access_token": "text"
}

Create a pairing code in order to pair a physical device to the virutal terminal profile.

post

https://api.brouwervos.nlhttps://staging.api.brouwervos.nl

/v1/companies/{companyId}/terminals/{terminalId}/pair

Create a pairing code in order to pair a physical device to the virutal terminal profile.

Authorizations

bearerAuth

Path parameters

companyIdstringRequired

Unique identifier of the company.

terminalIdstringRequired

Unique identifier of the terminal.

Responses

200

Detailed information about the terminal.

application/json

pairing_codestringOptional

404

Terminal or company not found.

post

/v1/companies/{companyId}/terminals/{terminalId}/pair

HTTPcURLJavaScriptPython

POST /v1/companies/{companyId}/terminals/{terminalId}/pair HTTP/1.1
Host: api.brouwervos.nl
Accept: */*

{
  "pairing_code": "text"
}