# Retrieving a list of transactions

Endpoint: GET /payment/{serviceId}/transactions
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `serviceId` (string, required)
    Service ID

## Response 200 fields (application/json):

  - `success` (boolean, required)
    Request status
    Example: true

  - `data` (array, required)
    Example: [{"id":"528bd43f-d08a-43f5-9462-861e54db37bf","status":"transaction_paid","amount":24.99,"control":null,"channel":"nest","paid_at":"2023-12-07T05:21:50+01:00","created_at":"2023-12-07T05:20:30+01:00","updated_at":"2023-12-07T05:21:50+01:00"},{"id":"0238d92e-0dd9-469a-9aa9-0505974336a3","status":"transaction_paid","amount":24.99,"control":null,"channel":"blik","paid_at":"2023-12-07T06:21:50+01:00","created_at":"2023-12-07T06:20:30+01:00","updated_at":"2023-12-07T06:21:50+01:00"}]

  - `data.id` (string, required)
    Transaction ID

  - `data.status` (string, required)
    Transaction status
    Enum: "transaction_new", "transaction_confirmed", "transaction_generated", "transaction_paid", "transaction_failure", "transaction_expired", "transaction_canceled", "transaction_refunded"

  - `data.amount` (number, required)

  - `data.control` (string, required)

  - `data.channel` (string, required)

  - `data.paid_at` (string, required)
    Creation date in format: ISO 8601

  - `data.created_at` (string, required)
    Creation date in format: ISO 8601

  - `data.updated_at` (string, required)
    Creation date in format: ISO 8601

  - `pagination` (object, required)

  - `pagination.total` (integer, required)
    Total number of records
    Example: 1

  - `pagination.count` (integer, required)
    Number of records on the current page
    Example: 1

  - `pagination.per_page` (integer, required)
    Maximum number of records per page
    Example: 15

  - `pagination.current_page` (integer, required)
    Current page
    Example: 1

  - `pagination.total_pages` (integer, required)
    Total number of pages
    Example: 1

  - `pagination.links` (object, required)
    URLs to pages

  - `pagination.links.next_page` (string,null, required)
    URL to the next page

  - `pagination.links.prev_page` (string,null, required)
    URL to the previous page

## Response 401 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "UNAUTHORIZED"

## Response 403 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "INVALID_ABILITY_PROVIDED", "IP_ADDRESS_NOT_WHITELISTED"

## Response 404 fields (application/json):

  - `success` (boolean, required)
    Request status

  - `errorCode` (string, required)
    Error status code
    Enum: "SERVICE_NOT_FOUND", "TRANSACTION_NOT_FOUND", "ROUTE_NOT_FOUND"