Skip to main content

List Network Tokens

GET/v2/network_tokens

Returns a paginated list of all network tokens belonging to the authenticated merchant.

statusString
Filter by token status: requested, active, suspended, failed, archive_pending, archived
networkString
Filter by card network: visa, mastercard
created_at[min]String
Filter by minimum creation date
created_at[max]String
Filter by maximum creation date
pageInteger
Page number (default: 1)
perInteger
Items per page (default: 20)
Example Request
GET /v2/network_tokens?status=active&page=1&per=20
Authorization: Basic <base64(api_key:api_password)>

Response​

data_setArray
Array of network token objects (see Create Network Token for object structure)
metadata.per_pageInteger
Items per page
metadata.total_itemsInteger
Total number of tokens
metadata.current_pageInteger
Current page number
metadata.total_pagesInteger
Total number of pages
linksObject
Pagination links (self, first, last, prev, next)
Example Response
{
"result": "OK",
"data_set": [
  {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "merchant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "active",
    "type": "merchant",
    "network": "visa",
    "provider": "vts",
    "last_token_refresh": "2026-03-31T14:31:46Z",
    "created_at": "2026-03-31T10:15:22Z",
    "updated_at": "2026-03-31T14:31:46Z"
  }
],
"metadata": {
  "per_page": 20,
  "total_items": 1,
  "current_page": 1,
  "total_pages": 1
},
"links": {
  "self": { "href": "https://api.betterpayment.de/v2/network_tokens?page=1" },
  "first": { "href": "https://api.betterpayment.de/v2/network_tokens?page=1" },
  "last": { "href": "https://api.betterpayment.de/v2/network_tokens?page=1" },
  "prev": { "href": "https://api.betterpayment.de/v2/network_tokens?page=1" },
  "next": { "href": "https://api.betterpayment.de/v2/network_tokens?page=1" }
}
}
Last updated on