---
title: "List retained results, V1 and V2 together"
method: GET
path: "/v2/einvoices/results"
tags: ["results"]
---

# List retained results, V1 and V2 together

`GET /v2/einvoices/results`

## Request

- Base URL: `https://api.ironfang.com/finance`
- URL: `https://api.ironfang.com/finance/v2/einvoices/results`
- Auth: HTTP bearer

A page of the organisation's retained results, newest first:
validations and generations made through V1 and validations made
through V2, each saying which API made it (`api_version`), the
schema of its retained document (`result_schema`) and its family.
`total` counts every matching record, expired and deleted ones
included; names are hidden after expiry or deletion and cannot
match `q`. Pass `next_cursor` as `cursor` for the next page.

V1's own result list shows only V1 results: a V2 result is not a
document its schema describes.

## Query parameters

- `cursor` string
- `limit` integer
- `kind` 'validate' | 'generate'
- `outcome` 'valid' | 'invalid'
- `family` 'peppol-bis-billing-3' | 'xrechnung' | 'zugferd-facturx': An invoice family. `zugferd-facturx` is one family: ZUGFeRD and Factur-X are corresponding release names of the same standard.
- `api_version` 'v1' | 'v2': The API a result was made through.
- `ruleset` string
- `q` string
- `operation_id` string

## Response `200`

The page. Cache-Control is no-store.

- RetainedResultList
  - `next_cursor` string
  - `results` RetainedResult[], required
    - `api_version` 'v1' | 'v2', required: The API a result was made through.
    - `available` boolean, required: The document can still be read; false once expired or erased.
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `display_name` string: The name given when the document was validated in the portal, while the result is available.
    - `expires_at` string, date-time, required
    - `family` 'peppol-bis-billing-3' | 'xrechnung' | 'zugferd-facturx', required: An invoice family. `zugferd-facturx` is one family: ZUGFeRD and Factur-X are corresponding release names of the same standard.
    - `kind` 'validate' | 'generate', required
    - `operation_id` string, required
    - `outcome` 'valid' | 'invalid', required
    - `result_schema` 'ironfang/finance/einvoice/validation-result/v2' | 'financewolf/einvoice/validation-result/v1' | 'financewolf/einvoice/generation-result/v1', required: The schema of a retained document.
    - `ruleset_id` string, required
  - `retention_days` 30, required
  - `schema` 'ironfang/finance/einvoice/result-list/v2', required
  - `total` integer, required

## Other responses

- `400`: The request is malformed.
- `401`: The credential is missing or not accepted.
- `403`: The key lacks the scope this operation needs.
- `429`: Too many requests.
- `500`: Ironfang Finance failed. Not a verdict on anything.

---

[API](https://skmtc.dev/ironfang/apis/ironfang-finance-e-invoicing-api-2.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-finance-e-invoicing-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-finance-e-invoicing-api-2/revisions/8140667e556b?raw)