Syntch Gateway API

<back to all web services

GetRegisters

Administration - Register Management
Requires Authentication
Requires any of the roles:Merchant, Reseller
The following routes are available for this service:
GET/registersGets a collection of registers for the merchant requester.
GetRegisters Parameters:
NameParameterData TypeRequiredDescription
SortFieldquerystringNoThe field name by which the records will be sorted. Default is 'RegisterNumber'.

Allowable Values

  • RegisterNumber
  • RegisterName
  • TerminalNumber
  • TerminalNumber2
  • ActivationStatus
  • RegisterKey
IncludeDeletedqueryboolNoWhether to include deleted records in the response, defaults to false.
RegisterKeyqueryint?NoFilter the customer records based on a specific customer key.
MerchantKeyqueryint?NoFilter the customer records based on a specific merchant key.
SortedRequestDto Parameters:
NameParameterData TypeRequiredDescription
SortDirectionquerystringNoThe direction in which the records will be sorted. Default is 'asc'.

Allowable Values

  • Asc
  • Desc
SortFieldquerystringNoThe field name by which the records will be sorted.
PaginatedRequestDto Parameters:
NameParameterData TypeRequiredDescription
PageSizequeryshortNoThe number of records per page. Default is 20.
PageNumberqueryshortNoThe page number to fetch. Default is 1.

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /registers HTTP/1.1 
Host: syntch.simpay.net 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

[
	{
		RegisterKey: 0,
		MerchantKey: 0,
		RegisterNumber: String,
		RegisterName: String,
		TerminalNumber: String,
		TerminalNumber2: String,
		ProcessorId: String,
		ActivationStatus: Pending,
		LastUpdateTimestamp: 0001-01-01
	}
]