Skip to main content

Get lists

GET 

https://device-api.prod-au1.tikpay.me/v1/lists

Get current contents of lists. Optional filter to limit which lists are returned. If no list types are provided, then all available lists are delivered.

Returns lists as simple lists of tokens and/or ranges, not as collections of ADD/REMOVE actions, for simple initialization or refresh of lists in their entirety.

The provided sequenceNo is the most recent sequence number included in these lists, which must be stored on the device for use in subsequent list delta calls.

Request

Query Parameters

    pageSize number

    Page Size. Maximum number of records to return. If not set, will return all records

    Example: 200
    listTypes string[]

    Optional list of ListTypes to filter to

    Example: DENY,DECLINE

Header Parameters

    Operator-Id stringrequired

    Header required for all calls. tikpay provided Operator ID

    Device-Id stringrequired

    Header required for all calls from devices. Device ID is unique within an Operator

    Hashkey-Version-Id stringrequired

    Is the version of the hash key the device is using (as provided by the server)

    Encryptionkey-Version-Id stringrequired

    Is the version of the encryption key the device is using (as provided by the server)

    Language-Id string

    Optional header to specify the language you wish the system to use for response messages. Pass appropriate IETF Language Tag. (https://en.wikipedia.org/wiki/IETF_language_tag) Defaults to English (en)

Responses

Contents of requested lists, as lists of tokens and/or ranges, along with the sequence number associated with the most recent record, for use in subsequent delta requests.

Schema
    sequenceNonumber
    Example: 1686114821
    lists object[]
  • Array [
  • listTypeListType (string)

    Possible values: [DECLINE, DENY, ACCEPT, APPROVE]

    Example: DENY
    tokensCredentialToken (string)[]
    rangesIINRange (string)[]
    parsPAR (string)[]
  • ]

Authorization: mutualTLS

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://device-api.prod-au1.tikpay.me/v1/lists");
request.Headers.Add("Accept", "application/json");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request Collapse all
Base URL
https://device-api.prod-au1.tikpay.me/v1
Auth
Parameters
— headerrequired
— headerrequired
— headerrequired
— headerrequired
— query
— query
— header