Activity Feed

Get transactions

get

Query parameters

accountIdsstring[]Optional

List of account IDs to filter transactions. If not provided, transactions from all accessible accounts are included.

Example: ["e0cab2dd-739f-43de-b131-3e423e935bf1"]

fromDatestring · nullableOptional

Start date for filtering transactions (inclusive). Expected format: YYYY-MM-DD. No lower bound if omitted.

Example: 2025-01-01

toDatestring · nullableOptional

End date for filtering transactions (inclusive). Expected format: YYYY-MM-DD. No upper bound if omitted.

Example: 2025-12-31

pagenumberRequired

Page number for paginated results. Starts from 1.

Default: 1Example: 1

limitnumber · max: 100Required

Number of transactions per page. Maximum allowed value is 100.

Default: 10Example: 10

Header parameters

authorizationstringOptional

Authorization header containing your API Token

x-alg-noncestringOptional

Nonce used to generate the payload signature

x-alg-signaturestringOptional

Payload signature

datestringOptional

Date of the request un UTC/GMT

Responses

200

List of transactions

application/json

objectOptional

and

400

Input validation error

application/json

get

/v1/partner/transactions

HTTPcURLJavaScriptPython

GET /v1/partner/transactions?page=1&limit=10 HTTP/1.1
Accept: */*

{
  "items": [
    {
      "transactionId": "68c2a19131a3b726fe47fdda",
      "uniqueToken": "1489dd60-aa06-48a6-a267-e7d4a9a84200",
      "origin": "TRANSFER",
      "state": "COMPLETED",
      "category": [
        "TRANSFERS"
      ],
      "impactType": "CREDIT",
      "customerId": "a2b9649e-df7f-4349-adff-1c57283fef10",
      "programId": "a2b9649e-df7f-4349-adff-1c57283fef10",
      "amount": 129,
      "currencyCode": "GBP",
      "description": "Sent from Algbra",
      "exchangeRate": "1.0",
      "exchangeCurrencyCode": "GBP",
      "sourceCounterparty": {
        "type": "PERSONAL",
        "details": {
          "firstName": "John",
          "lastName": "Doe"
        },
        "accountCurrency": "GBP",
        "accountReferenceType": "UK_ACCOUNT",
        "accountReference": {
          "type": "UK_ACCOUNT",
          "sortCode": "010102",
          "accountNumber": "12345678"
        },
        "address": {
          "buildingName": "Eiffel Tower",
          "buildingNumber": "10",
          "state": "Île-de-France",
          "street": "Av. Gustave Eiffel",
          "town": "Paris",
          "postcode": "75007",
          "country": "FRA"
        }
      },
      "destinationCounterparty": {
        "type": "PERSONAL",
        "details": {
          "firstName": "John",
          "lastName": "Doe"
        },
        "accountCurrency": "GBP",
        "accountReferenceType": "UK_ACCOUNT",
        "accountReference": {
          "type": "UK_ACCOUNT",
          "sortCode": "010102",
          "accountNumber": "12345678"
        },
        "address": {
          "buildingName": "Eiffel Tower",
          "buildingNumber": "10",
          "state": "Île-de-France",
          "street": "Av. Gustave Eiffel",
          "town": "Paris",
          "postcode": "75007",
          "country": "FRA"
        }
      },
      "transactionDate": "2025-01-01T10:32:01.162Z",
      "cardMetadata": {
        "phase": "AUTHORIZATION",
        "type": "CARD_PAYMENT",
        "cardToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
        "transactionToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
        "eventToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
        "lastDigits": "1234",
        "scheme": {
          "network": "MasterCard",
          "binPrefix": "5432",
          "referenceId": "ref123"
        },
        "cardAcceptor": {
          "mcc": "5411",
          "name": "Supermarket",
          "city": "London",
          "country": "GB"
        },
        "pos": {
          "cardPresent": true,
          "pinPresent": false,
          "terminalId": "TERM001"
        },
        "merchant": {
          "name": "Tesco",
          "summary": "Hyper-Supermarket",
          "imageUrl": "https://s3.eu-central-1.amazonaws.com/files.node-prod.dateio.cz/m/538VqZ4gn33tVJJWEYa8d3/l",
          "location": {
            "latitude": 51.46358,
            "longitude": -0.1861
          }
        }
      },
      "transferMetadata": {
        "rails": "FASTER_PAYMENTS",
        "transactionProgress": [
          {
            "event": "COMPLETED",
            "date": "2025-01-01T10:16:49.621Z"
          }
        ],
        "fundingSourceProvider": {
          "id": "f49281c0-0840-55bd-95b3-3b46d1d0e9f1",
          "name": "John Doe",
          "type": "PISP",
          "logo": "https://app-static.algbra.com/banklogo/mock-payments-gb-redirect.png"
        }
      }
    }
  ],
  "meta": {
    "currentPage": 1,
    "itemCount": 10,
    "itemsPerPage": 10,
    "totalItems": 100,
    "totalPages": 10
  }
}

Get transaction

get

Path parameters

transactionIdstringRequired

Header parameters

authorizationstringOptional

Authorization header containing your API Token

x-alg-noncestringOptional

Nonce used to generate the payload signature

x-alg-signaturestringOptional

Payload signature

datestringOptional

Date of the request un UTC/GMT

Responses

200

Transaction detail

application/json

transactionIdstringRequired

Unique identifier of the transaction

Example: 68c2a19131a3b726fe47fdda

uniqueTokenstring · uuidRequired

Unique token of the transaction

Example: 1489dd60-aa06-48a6-a267-e7d4a9a84200

originstring · enumRequired

Origin of the transaction

Example: TRANSFERPossible values:

statestring · enumRequired

Current state of the transaction

Example: COMPLETEDPossible values:

categorystring · enumRequired

Category of the transaction

Example: ["TRANSFERS"]Possible values:

impactTypestring · enumRequired

Indicates if the transaction is a debit or credit

Example: CREDITPossible values:

customerIdstring · uuid · nullableRequired

Customer identifier associated with this transaction

Example: a2b9649e-df7f-4349-adff-1c57283fef10

programIdstring · uuid · nullableRequired

Program account identifier associated with this transaction

Example: a2b9649e-df7f-4349-adff-1c57283fef10

amountnumberRequired

Transaction amount in minor units (e.g. 129 for £1.29)

Example: 129

currencyCodestring · enumRequired

Currency of the transaction amount

Example: GBPPossible values:

descriptionstringRequired

Description of the transaction

Example: Sent from Algbra

exchangeRatestringRequired

Exchange rate applied to this transaction

Example: 1.0

exchangeCurrencyCodestring · enumRequired

Currency used for exchange in this transaction

Example: GBPPossible values:

sourceCounterpartyone ofRequired

Details of the counterparty sending the payment, if applicable

or

destinationCounterpartyone ofRequired

Details of the counterparty receiving the payment, if applicable

or

transactionDatestring · date-timeRequired

Timestamp when the transaction took place

Example: 2025-01-01T10:32:01.162Z

400

Input validation error

application/json

403

Forbidden

application/json

404

Transaction not found

application/json

get

/v1/partner/transactions/{transactionId}

HTTPcURLJavaScriptPython

GET /v1/partner/transactions/{transactionId} HTTP/1.1
Accept: */*

{
  "transactionId": "68c2a19131a3b726fe47fdda",
  "uniqueToken": "1489dd60-aa06-48a6-a267-e7d4a9a84200",
  "origin": "TRANSFER",
  "state": "COMPLETED",
  "category": [
    "TRANSFERS"
  ],
  "impactType": "CREDIT",
  "customerId": "a2b9649e-df7f-4349-adff-1c57283fef10",
  "programId": "a2b9649e-df7f-4349-adff-1c57283fef10",
  "amount": 129,
  "currencyCode": "GBP",
  "description": "Sent from Algbra",
  "exchangeRate": "1.0",
  "exchangeCurrencyCode": "GBP",
  "sourceCounterparty": {
    "type": "PERSONAL",
    "details": {
      "firstName": "John",
      "lastName": "Doe"
    },
    "accountCurrency": "GBP",
    "accountReferenceType": "UK_ACCOUNT",
    "accountReference": {
      "type": "UK_ACCOUNT",
      "sortCode": "010102",
      "accountNumber": "12345678"
    },
    "address": {
      "buildingName": "Eiffel Tower",
      "buildingNumber": "10",
      "state": "Île-de-France",
      "street": "Av. Gustave Eiffel",
      "town": "Paris",
      "postcode": "75007",
      "country": "FRA"
    }
  },
  "destinationCounterparty": {
    "type": "PERSONAL",
    "details": {
      "firstName": "John",
      "lastName": "Doe"
    },
    "accountCurrency": "GBP",
    "accountReferenceType": "UK_ACCOUNT",
    "accountReference": {
      "type": "UK_ACCOUNT",
      "sortCode": "010102",
      "accountNumber": "12345678"
    },
    "address": {
      "buildingName": "Eiffel Tower",
      "buildingNumber": "10",
      "state": "Île-de-France",
      "street": "Av. Gustave Eiffel",
      "town": "Paris",
      "postcode": "75007",
      "country": "FRA"
    }
  },
  "transactionDate": "2025-01-01T10:32:01.162Z",
  "cardMetadata": {
    "phase": "AUTHORIZATION",
    "type": "CARD_PAYMENT",
    "cardToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
    "transactionToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
    "eventToken": "1483d25d-3f00-4d39-90ce-2379a130becd",
    "lastDigits": "1234",
    "scheme": {
      "network": "MasterCard",
      "binPrefix": "5432",
      "referenceId": "ref123"
    },
    "cardAcceptor": {
      "mcc": "5411",
      "name": "Supermarket",
      "city": "London",
      "country": "GB"
    },
    "pos": {
      "cardPresent": true,
      "pinPresent": false,
      "terminalId": "TERM001"
    },
    "merchant": {
      "name": "Tesco",
      "summary": "Hyper-Supermarket",
      "imageUrl": "https://s3.eu-central-1.amazonaws.com/files.node-prod.dateio.cz/m/538VqZ4gn33tVJJWEYa8d3/l",
      "location": {
        "latitude": 51.46358,
        "longitude": -0.1861
      }
    }
  },
  "transferMetadata": {
    "rails": "FASTER_PAYMENTS",
    "transactionProgress": [
      {
        "event": "COMPLETED",
        "date": "2025-01-01T10:16:49.621Z"
      }
    ],
    "fundingSourceProvider": {
      "id": "f49281c0-0840-55bd-95b3-3b46d1d0e9f1",
      "name": "John Doe",
      "type": "PISP",
      "logo": "https://app-static.algbra.com/banklogo/mock-payments-gb-redirect.png"
    }
  }
}