---
title: "Retrieve a list of purchase details"
method: GET
path: "/v1/"
tags: ["Get purchase details"]
---

# Retrieve a list of purchase details

`GET /v1/`

This operation will return purchase details

## Query parameters

- `page` integer
- `size` integer
- `filter` string — The filter currently accepts two search fields; `externalId` and `transactionId` which you can match with the operator `eq`. Two logical operators; AND and OR are supported, which means that you can combine a filter Ex. `?filter=externalId eq 1234`, `?filter=externalId eq 1234 AND transactionId eq 2222`
- `auditUser` string, required

## Response `200`

Successfully retrieved

- union[]
  - union
    - FuelPurchaseDetailResponse
      - `amount` Money — Amount including currency
        - `amount` number
        - `currency` string — A valid ISO 4217 currency code
      - `code` string — Issuer defined code for purchase detail. Code can e.g. represent a product category like “newspapers”. Code is utilised if item is processed through repricing.
      - `description` string — Issuer defined description of purchase detail. The description is set when creating purchase details and is available when fetching purchase details via API and in the invoicing file.
      - `externalId` string — Issuer defined external id. Issuer can store an external id to each purchase detail as a common key between Enfuce and issuer systems.
      - `matchingAttributes` KeyValuePair[] — Attributes that enable Enfuce to link purchase detail to a financial transaction. The most suitable matching attributes are agreed with issuer during implementation.
        - `key` string, required
        - `value` string, required
      - `promptedData` KeyValuePair[] — Prompted data linked to the purchase detail
        - `key` string, required
        - `value` string, required
      - `quantity` number — The quantity purchased. This can be a number or in combination with unit define e.g. how many liters or kilograms have been purchased.
      - `transactionId` string — Id of the financial transaction the purchase detail is linked to. The transactionId is updated by Enfuce after a match is found between financial transaction and purchase detail.
      - `type` 'FUEL' | 'OTHER' — The type of item
      - `unitPrice` number — Price per unit
      - `VAT` VATValues
        - `percentage` number
        - `amount` Money — Amount including currency
          - `amount` number
          - `currency` string — A valid ISO 4217 currency code
      - `unit` 'KG' | 'KWH' | 'LITRE' | 'GALLON' — Unit of measurement of quantity. Obsolete in cases where the purchase detail represents one item or a number of the same items.
      - `id` string — Unique id that represents this purchase detail
    - OtherPurchaseDetailResponse
      - `amount` Money — Amount including currency
        - `amount` number
        - `currency` string — A valid ISO 4217 currency code
      - `code` string — Issuer defined code for purchase detail. Code can e.g. represent a product category like “newspapers”. Code is utilised if item is processed through repricing.
      - `description` string — Issuer defined description of purchase detail. The description is set when creating purchase details and is available when fetching purchase details via API and in the invoicing file.
      - `externalId` string — Issuer defined external id. Issuer can store an external id to each purchase detail as a common key between Enfuce and issuer systems.
      - `matchingAttributes` KeyValuePair[] — Attributes that enable Enfuce to link purchase detail to a financial transaction. The most suitable matching attributes are agreed with issuer during implementation.
        - `key` string, required
        - `value` string, required
      - `promptedData` KeyValuePair[] — Prompted data linked to the purchase detail
        - `key` string, required
        - `value` string, required
      - `quantity` number — The quantity purchased. This can be a number or in combination with unit define e.g. how many liters or kilograms have been purchased.
      - `transactionId` string — Id of the financial transaction the purchase detail is linked to. The transactionId is updated by Enfuce after a match is found between financial transaction and purchase detail.
      - `type` 'FUEL' | 'OTHER' — The type of item
      - `unitPrice` number — Price per unit
      - `VAT` VATValues
        - `percentage` number
        - `amount` Money — Amount including currency
          - `amount` number
          - `currency` string — A valid ISO 4217 currency code
      - `unit` 'KG' | 'KWH' | 'LITRE' | 'GALLON' — Unit of measurement of quantity. Obsolete in cases where the purchase detail represents one item or a number of the same items.
      - `id` string — Unique id that represents this purchase detail

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/revisions/dc4a41118f80/schema)